SunSPOT API V3.0


com.sun.squawk.io.j2me.memory
Class Protocol

java.lang.Object
  extended by com.sun.squawk.io.ConnectionBase
      extended by com.sun.squawk.io.j2me.memory.Protocol
All Implemented Interfaces:
Connection, InputConnection, OutputConnection, StreamConnection

public class Protocol
extends ConnectionBase
implements StreamConnection

This class allows access to the raw memory of the host device from the GCF framework. The access provided is read-only, and so attempts to open output streams will generate IllegalStateExceptions. If you want to write to flash memory, see IFlashMemoryDevice

You should normally access this class indirectly via the GCF framework. For example:

...
int memAddress= 0x10000;
StreamConnection conn = (StreamConnection) Connector.open("memory://" + memAddress);
MemoryInputStream mis = (MemoryInputStream)conn.openInputStream();
...

See Also:
MemoryInputStream

Constructor Summary
Protocol()
           
 
Method Summary
 Connection open(String protocolName, String name, int mode, boolean timeouts)
          Open a connection to a target.
 InputStream openInputStream()
          Open and return an input stream for a connection.
 OutputStream openOutputStream()
          Throws IllegalStateException (output not supported for memory streams).
 
Methods inherited from class com.sun.squawk.io.ConnectionBase
close, openDataInputStream, openDataOutputStream
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface javax.microedition.io.InputConnection
openDataInputStream
 
Methods inherited from interface javax.microedition.io.Connection
close
 
Methods inherited from interface javax.microedition.io.OutputConnection
openDataOutputStream
 
Methods inherited from interface javax.microedition.io.Connection
close
 

Constructor Detail

Protocol

public Protocol()
Method Detail

open

public Connection open(String protocolName,
                       String name,
                       int mode,
                       boolean timeouts)
Description copied from class: ConnectionBase
Open a connection to a target.

Specified by:
open in class ConnectionBase
Parameters:
protocolName - The URL protocol
name - The URL for the connection
mode - The access mode
timeouts - A flag to indicate that the caller wants timeout exceptions
Returns:
A new Connection object

openInputStream

public InputStream openInputStream()
Open and return an input stream for a connection.

Specified by:
openInputStream in interface InputConnection
Overrides:
openInputStream in class ConnectionBase
Returns:
An input stream

openOutputStream

public OutputStream openOutputStream()
Throws IllegalStateException (output not supported for memory streams). If you want to write to flash memory, see IFlashMemoryDevice

Specified by:
openOutputStream in interface OutputConnection
Overrides:
openOutputStream in class ConnectionBase
Returns:
An output stream

SunSPOT API V3.0


Copyright © 2006, 2007 Sun Microsystems, Inc. All Rights Reserved.