USRE-85 Fixed the error for docs build
This commit is contained in:
parent
7b8fac5b1d
commit
6a67a236c6
|
@ -9,7 +9,7 @@ import java.util.Vector;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* A class to provide a {@link javax.activation.DataSource} interface to
|
* A class to provide a {@link javax.activation.DataSource} interface to
|
||||||
* an input stream of unknown characteristics. The <code>DataSource</cdoe>
|
* an input stream of unknown characteristics. The <code>DataSource</code>
|
||||||
* interface requires that its implementor be able to repeatedly restart
|
* interface requires that its implementor be able to repeatedly restart
|
||||||
* the read from the beginning. This isn't guaranteed by InputStream, so
|
* the read from the beginning. This isn't guaranteed by InputStream, so
|
||||||
* we encapsulate the InputStream with an object that will buffer the
|
* we encapsulate the InputStream with an object that will buffer the
|
||||||
|
|
|
@ -90,7 +90,7 @@ public class RETSConnection extends java.lang.Object {
|
||||||
/**
|
/**
|
||||||
* Executes a transaction
|
* Executes a transaction
|
||||||
*
|
*
|
||||||
* @param RETSTransaction transaction to execute
|
* @param transaction transaction to execute
|
||||||
*/
|
*/
|
||||||
public void execute(RETSTransaction transaction) {
|
public void execute(RETSTransaction transaction) {
|
||||||
execute(transaction, false);
|
execute(transaction, false);
|
||||||
|
@ -99,7 +99,7 @@ public class RETSConnection extends java.lang.Object {
|
||||||
/**
|
/**
|
||||||
* Executes a transaction
|
* Executes a transaction
|
||||||
*
|
*
|
||||||
* @param RETSTransaction transaction to execute
|
* @param transaction transaction to execute
|
||||||
*/
|
*/
|
||||||
public void executeStreamResponse(RETSTransaction transaction) {
|
public void executeStreamResponse(RETSTransaction transaction) {
|
||||||
execute(transaction, true);
|
execute(transaction, true);
|
||||||
|
|
|
@ -16,11 +16,10 @@ import java.util.Iterator;
|
||||||
/**
|
/**
|
||||||
* RETSGetObjectTransaction.java
|
* RETSGetObjectTransaction.java
|
||||||
*
|
*
|
||||||
* @version 1.0
|
|
||||||
* @author jbrush
|
* @author jbrush
|
||||||
|
* @version 1.0
|
||||||
*/
|
*/
|
||||||
public class RETSGetObjectTransaction extends RETSTransaction
|
public class RETSGetObjectTransaction extends RETSTransaction {
|
||||||
{
|
|
||||||
/**
|
/**
|
||||||
* Encapsulates the RETS GetObject transaction, and provides services for
|
* Encapsulates the RETS GetObject transaction, and provides services for
|
||||||
* interpreting the result. As with all {@link RETSTransaction} classes,
|
* interpreting the result. As with all {@link RETSTransaction} classes,
|
||||||
|
@ -66,10 +65,11 @@ public class RETSGetObjectTransaction extends RETSTransaction
|
||||||
setRequestVariable("Resource", str);
|
setRequestVariable("Resource", str);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Sets the type attribute to the string passed in.
|
* Sets the type attribute to the string passed in.
|
||||||
*
|
*
|
||||||
* @param type type attribute value
|
* @param str type attribute value
|
||||||
*/
|
*/
|
||||||
public void setType(String str) {
|
public void setType(String str) {
|
||||||
logger.debug("set Type=" + str);
|
logger.debug("set Type=" + str);
|
||||||
|
@ -103,7 +103,7 @@ public class RETSGetObjectTransaction extends RETSTransaction
|
||||||
/**
|
/**
|
||||||
* Sets the response stream. This triggers various actions depending on the
|
* Sets the response stream. This triggers various actions depending on the
|
||||||
* content-type of the response stream:
|
* content-type of the response stream:
|
||||||
|
* <p>
|
||||||
* If the content-type is text/plain or text/xml, then assume we have a
|
* If the content-type is text/plain or text/xml, then assume we have a
|
||||||
* RETS response and parse it accordingly. Note that we'll not have
|
* RETS response and parse it accordingly. Note that we'll not have
|
||||||
* anything in the RETS response except error information. (We might
|
* anything in the RETS response except error information. (We might
|
||||||
|
@ -111,18 +111,17 @@ public class RETSGetObjectTransaction extends RETSTransaction
|
||||||
* is that we made a request with Location=1 and the server has
|
* is that we made a request with Location=1 and the server has
|
||||||
* responded in kind.) We still make this available, in case there *is*
|
* responded in kind.) We still make this available, in case there *is*
|
||||||
* something else in the response.
|
* something else in the response.
|
||||||
|
* <p>
|
||||||
* A content-type of<code> multipart</code>, with any subtype, is interpreted as a
|
* A content-type of<code> multipart</code>, with any subtype, is interpreted as a
|
||||||
* multipart response. This is parsed to create a list of MIME parts.
|
* multipart response. This is parsed to create a list of MIME parts.
|
||||||
* Any other content type is simply made available as a single MIME part.
|
* Any other content type is simply made available as a single MIME part.
|
||||||
|
* <p>
|
||||||
* This method is called by {@link RETSConnection} to provide access to
|
* This method is called by {@link RETSConnection} to provide access to
|
||||||
* the response from a transaction. You don't normally call this method
|
* the response from a transaction. You don't normally call this method
|
||||||
* yourself.
|
* yourself.
|
||||||
*
|
*
|
||||||
* @param responseStream The response stream to associate with this transaction.
|
* @param responseStream The response stream to associate with this transaction.
|
||||||
* @call Rarely.
|
* Rarely. You can override this method if you want to provide
|
||||||
* @override Rarely. You can override this method if you want to provide
|
|
||||||
* special processing of a GetObject response stream, but
|
* special processing of a GetObject response stream, but
|
||||||
* it will usually be more convenient to override one
|
* it will usually be more convenient to override one
|
||||||
* of the methods that handles particular MIME types.
|
* of the methods that handles particular MIME types.
|
||||||
|
@ -172,8 +171,7 @@ public class RETSGetObjectTransaction extends RETSTransaction
|
||||||
* deal with it. If not, handle as for an unknown response.
|
* deal with it. If not, handle as for an unknown response.
|
||||||
*
|
*
|
||||||
* @param responseStream The response stream containing the XML data.
|
* @param responseStream The response stream containing the XML data.
|
||||||
* @call Only from subclasses.
|
* Override to provide your own handling of XML data
|
||||||
* @ @override Override to provide your own handling of XML data
|
|
||||||
* streams.
|
* streams.
|
||||||
*/
|
*/
|
||||||
protected void handleXMLStream(InputStream responseStream, String mimeType, String contentType) {
|
protected void handleXMLStream(InputStream responseStream, String mimeType, String contentType) {
|
||||||
|
@ -203,11 +201,7 @@ public class RETSGetObjectTransaction extends RETSTransaction
|
||||||
*
|
*
|
||||||
* @param responseStream The stream to parse.
|
* @param responseStream The stream to parse.
|
||||||
* @param mimeType The MIME type and subtype associated with the stream.
|
* @param mimeType The MIME type and subtype associated with the stream.
|
||||||
* @param contentType The Content-Type header, including the MIME type and its parameters, if any.
|
* @param contentType The Content-Type header, including the MIME type and its parameters, if any
|
||||||
* @call Only from subclasses.
|
|
||||||
* @override Override to provide your own handling of MIME multipart
|
|
||||||
* <p/>
|
|
||||||
* data.
|
|
||||||
*/
|
*/
|
||||||
protected void handleMultipartStream(InputStream responseStream, String mimeType, String contentType) {
|
protected void handleMultipartStream(InputStream responseStream, String mimeType, String contentType) {
|
||||||
|
|
||||||
|
@ -250,8 +244,6 @@ public class RETSGetObjectTransaction extends RETSTransaction
|
||||||
*
|
*
|
||||||
* @param inputBytes A byte array containing the response data.
|
* @param inputBytes A byte array containing the response data.
|
||||||
* @param contentType The content-type header.
|
* @param contentType The content-type header.
|
||||||
* @call Rarely.
|
|
||||||
* @override Rarely.
|
|
||||||
*/
|
*/
|
||||||
protected void makeSinglePartFromByteStream(byte[] inputBytes, String contentType) {
|
protected void makeSinglePartFromByteStream(byte[] inputBytes, String contentType) {
|
||||||
// First, we need to gather the response headers into an InternetHeader object
|
// First, we need to gather the response headers into an InternetHeader object
|
||||||
|
@ -286,9 +278,7 @@ public class RETSGetObjectTransaction extends RETSTransaction
|
||||||
* @param responseStream The stream to parse.
|
* @param responseStream The stream to parse.
|
||||||
* @param mimeType The MIME type and subtype associated with the stream.
|
* @param mimeType The MIME type and subtype associated with the stream.
|
||||||
* @param contentType The Content-Type header, including the MIME type and its parameters, if any.
|
* @param contentType The Content-Type header, including the MIME type and its parameters, if any.
|
||||||
* @call Only from subclasses.
|
* <p>
|
||||||
* @override Override to provide your own handling of data with special
|
|
||||||
* <p/>
|
|
||||||
* MIME types.
|
* MIME types.
|
||||||
*/
|
*/
|
||||||
protected void handleStreamWithType(InputStream responseStream, String mimeType, String contentType) {
|
protected void handleStreamWithType(InputStream responseStream, String mimeType, String contentType) {
|
||||||
|
|
|
@ -23,7 +23,7 @@ public class RETSSearchAgentTransaction extends RETSSearchTransaction {
|
||||||
|
|
||||||
/** Search by last name, pass in the lastname of a user
|
/** Search by last name, pass in the lastname of a user
|
||||||
* as the "query" argument.
|
* as the "query" argument.
|
||||||
* @param searchByLastName lastname of the user to search.
|
* @param searchByLastname lastname of the user to search.
|
||||||
*/
|
*/
|
||||||
public void setSearchByLastname(String searchByLastname) {
|
public void setSearchByLastname(String searchByLastname) {
|
||||||
// convert to DMQL
|
// convert to DMQL
|
||||||
|
|
Loading…
Reference in New Issue