de.enough.polish.android.obex
Interface Operation

public interface Operation

The Operation interface provides ways to manipulate a single OBEX PUT or GET operation. The implementation of this interface sends OBEX packets as they are built. If during the operation the peer in the operation ends the operation, an IOException is thrown on the next read from the input stream, write to the output stream, or call to sendHeaders(). Definition of methods inherited from ContentConnection getEncoding() will always return null.
getLength() will return the length specified by the OBEX Length header or -1 if the OBEX Length header was not included.
getType() will return the value specified in the OBEX Type header or null if the OBEX Type header was not included.
How Headers are Handled As headers are received, they may be retrieved through the getReceivedHeaders() method. If new headers are set during the operation, the new headers will be sent during the next packet exchange. PUT example

 void putObjectViaOBEX(ClientSession conn, HeaderSet head, byte[] obj)
 throws IOException {
 
 // Include the length header
 head.setHeader(head.LENGTH, new Long(obj.length));
 
 // Initiate the PUT request
 Operation op = conn.put(head);
 
 // Open the output stream to put the object to it
 DataOutputStream out = op.openDataOutputStream();
 
 // Send the object to the server
 out.write(obj);
 
 // End the transaction
 out.close();
 op.close();
 }
 

GET example

 byte[] getObjectViaOBEX(ClientSession conn,
 HeaderSet head) throws IOException {
 
 // Send the initial GET request to the server
 Operation op = conn.get(head);
 
 // Retrieve the length of the object being sent back
 int length = op.getLength();
 
 // Create space for the object
 byte[] obj = new byte[length];
 
 // Get the object from the input stream
 DataInputStream in = trans.openDataInputStream();
 in.read(obj);
 
 // End the transaction
 in.close();
 op.close();
 
 return obj;
 }
 

Client PUT Operation Flow

For PUT operations, a call to close() the OutputStream returned from openOutputStream() or openDataOutputStream() will signal that the request is done. (In OBEX terms, the End-Of-Body header should be sent and the final bit in the request will be set.) At this point, the reply from the server may begin to be processed. A call to getResponseCode() will do an implicit close on the OutputStream and therefore signal that the request is done.

Client GET Operation Flow

For GET operation, a call to openInputStream() or openDataInputStream() will signal that the request is done. (In OBEX terms, the final bit in the request will be set.) A call to getResponseCode() will cause an implicit close on the InputStream. No further data may be read at this point.

1.2

Method Summary

void	abort() Sends an ABORT message to the server.
HeaderSet	getReceivedHeaders() Returns the headers that have been received during the operation.
int	getResponseCode() Returns the response code received from the server.
void	sendHeaders(HeaderSet headers) Specifies the headers that should be sent in the next OBEX message that is sent.

Method Detail

abort

 void abort()
 throws java.io.IOException

Sends an ABORT message to the server. By calling this method, the corresponding input and output streams will be closed along with this object. No headers are sent in the abort request. This will end the operation since close() will be called by this method.

java.io.IOException - if the transaction has already ended or if an OBEX server calls this method

getReceivedHeaders

 HeaderSet getReceivedHeaders()
 throws java.io.IOException

Returns the headers that have been received during the operation. Modifying the object returned has no effect on the headers that are sent or retrieved.

java.io.IOException - if this Operation has been closed

sendHeaders

 void sendHeaders(HeaderSet headers)
 throws java.io.IOException

Specifies the headers that should be sent in the next OBEX message that is sent.

java.io.IOException - if this Operation has been closed or the transaction has ended and no further messages will be exchanged

java.lang.IllegalArgumentException - if headers was not created by a call to ServerRequestHandler.createHeaderSet() or ClientSession.createHeaderSet()

java.lang.NullPointerException - if headers if null

getResponseCode

 int getResponseCode()
 throws java.io.IOException

Returns the response code received from the server. Response codes are defined in the ResponseCodes class.

java.io.IOException - if an error occurred in the transport layer during the transaction; if this object was created by an OBEX server

See Also:

ResponseCodes