|
JXTA | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.jxta.impl.endpoint.cbjx.CbJxTransport
public class CbJxTransport
A JXTA MessageTransport
implementation which
which provides message verification by examining message signatures. A
virtual transport, the messages are transfered between peers using some
other message transport.
Nested Class Summary | |
---|---|
class |
CbJxTransport.CbJxInputFilter
this class filters incoming messages. |
class |
CbJxTransport.CbJxOutputFilter
this class filters all outgoing messages that are not sent with messengers. |
Field Summary | |
---|---|
(package private) static String |
CBJX_MSG_BODY
the name of the cbjx body element |
(package private) static String |
CBJX_MSG_INFO
the name of the cbjx crypto element |
static String |
CBJX_MSG_NS
the name of the cbjx valid element |
(package private) static String |
CBJX_MSG_SIG
the name of the cbjx body element |
(package private) static String |
cbjxProtocolName
the cbjx protocol name |
(package private) static String |
cbjxServiceName
the cbjx service name |
(package private) EndpointService |
endpoint
the endpoint service in my group |
(package private) PeerGroup |
group
the peer group to which this module belongs |
(package private) static EndpointAddress |
localPeerAddr
the endpoint address of this peer |
(package private) static PeerID |
localPeerID
the local peer ID |
(package private) PSEMembershipService |
membership
the membership service in my group |
Fields inherited from interface net.jxta.platform.Module |
---|
START_AGAIN_PROGRESS, START_AGAIN_STALLED, START_DISABLED, START_OK |
Constructor Summary | |
---|---|
CbJxTransport()
Default constructor |
Method Summary | |
---|---|
Message |
addCryptoInfo(Message submessage,
EndpointAddress destAddress)
add the CryptoInfo into the message |
boolean |
allowsRouting()
Returns true if the Message Transport can be used by the EndpointRouter. |
Message |
checkCryptoInfo(Message message,
MessageElement cryptoElement,
CbJxMessageInfo cryptoInfo)
|
EndpointService |
getEndpointService()
Returns the endpoint service with which this MessageTransport is registered. |
Messenger |
getMessenger(EndpointAddress dest,
Object hintIgnored)
Return a Messenger for sending messages to the specified
destination EndpointAddress . |
String |
getProtocolName()
Returns a String containing the name of the protocol used by this MessageTransport. |
EndpointAddress |
getPublicAddress()
Returns the EndpointAddress which will be used as the source
address for all messages sent by this message sender. |
Iterator |
getPublicAddresses()
Returns an Iterator of all of the EndpointAddresses by which this
MessageReceiver is reachable. |
void |
init(PeerGroup group,
ID assignedID,
Advertisement impl)
Initialize the module, passing it its peer group and advertisement. |
boolean |
isConnectionOriented()
Returns true if the Message Transport is connection oriented
(like TCP/IP). |
boolean |
ping(EndpointAddress addr)
Deprecated. |
void |
processIncomingMessage(Message message,
EndpointAddress srcAddr,
EndpointAddress dstAddr)
This method is invoked by the EndpointService for each incoming message which is addressed to this listener. |
int |
startApp(String[] arg)
Complete any remaining initialization of the module. |
void |
stopApp()
Stop a module. |
Object |
transportControl(Object operation,
Object value)
Pass a transport control object to a message transport. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String CBJX_MSG_NS
static final String CBJX_MSG_INFO
static final String CBJX_MSG_BODY
static final String CBJX_MSG_SIG
static final String cbjxProtocolName
static final String cbjxServiceName
static PeerID localPeerID
static EndpointAddress localPeerAddr
PeerGroup group
EndpointService endpoint
PSEMembershipService membership
Constructor Detail |
---|
public CbJxTransport()
Method Detail |
---|
public void init(PeerGroup group, ID assignedID, Advertisement impl) throws PeerGroupException
init
in interface Module
group
- The PeerGroup from which this Module can obtain services.
If this module is a Service, this is also the PeerGroup of which this
module is a service.assignedID
- Identity of Module within group.
modules can use it as a the root of their namespace to create
names that are unique within the group but predictable by the
same module on another peer. This is normally the ModuleClassID
which is also the name under which the module is known by other
modules. For a group it is the PeerGroupID itself.
The parameters of a service, in the Peer configuration, are indexed
by the assignedID of that service, and a Service must publish its
run-time parameters in the Peer Advertisement under its assigned ID.impl
- The implementation advertisement for this
Module. It is permissible to pass null if no implementation
advertisement is available. This may happen if the
implementation was selected by explicit class name rather than
by following an implementation advertisement. Modules are not
required to support that style of loading, but if they do, then
their documentation should mention it.
PeerGroupException
- This module failed to initialize.public int startApp(String[] arg)
startApp()
is completed. That is
also the opportunity to supply arbitrary arguments (mostly to
applications).
If this module is a PeerGroup
service, it may be invoked
several times depending on its return value.
startApp
in interface Module
arg
- An array of Strings forming the parameters for this
Module.
Module.START_OK
, Module.START_AGAIN_PROGRESS
,
Module.START_AGAIN_STALLED
, which indicates partial or complete
success, or any other value (negative values are
recommended for future compatibility), which indicates failure.public void stopApp()
init()
completes and should not assume that startApp()
has been
called or completed.
The Module cannot be forced to comply, but in the future
we might be able to deny it access to anything after some timeout.
stopApp
in interface Module
public EndpointAddress getPublicAddress()
EndpointAddress
which will be used as the source
address for all messages sent by this message sender. This is the
"preferred" address to which replies should be sent. This address is not
necessarily the best or only address by which the peer may be reached.
The public address may also be for a different message transport.
getPublicAddress
in interface MessageSender
public boolean isConnectionOriented()
true
if the Message Transport is connection oriented
(like TCP/IP). Indicates that the Message Transport can provide
efficient transport of a series of messages to the same destination.
isConnectionOriented
in interface MessageSender
true
if the Message Transport is connection oriented.public boolean allowsRouting()
getReachableEndpointAddresses
.
allowsRouting
in interface MessageSender
public EndpointService getEndpointService()
getEndpointService
in interface MessageTransport
public Object transportControl(Object operation, Object value)
transportControl
in interface MessageTransport
operation
- Object that specifies the type of control operation
to be performedvalue
- Object that specifies a value object associated
with the control operation
public Iterator getPublicAddresses()
EndpointAddresses
by which this
MessageReceiver is reachable. The list is in order of
"preference" with the most "preferred" EndpointAddress being at the
beginning of the list.
getPublicAddresses
in interface MessageReceiver
public String getProtocolName()
EndpointAddress
.
getProtocolName
in interface MessageTransport
public Messenger getMessenger(EndpointAddress dest, Object hintIgnored)
Messenger
for sending messages to the specified
destination EndpointAddress
.
getMessenger
in interface MessageSender
dest
- The destination address for which a messenger is requested.hintIgnored
- An optional hint for the transport to use when creating the
messenger. The format of the hint is specific to each Message Transport
and may be null
if no hint is provided.
null
if the destination is not reachable.@Deprecated public boolean ping(EndpointAddress addr)
true
if the specified destination address is reachable
via this Message Transport otherwise returns false
.
ping
in interface MessageSender
addr
- Address to ping
true
if the specified destination address is reachable
via this Message Transport otherwise returns false
.public void processIncomingMessage(Message message, EndpointAddress srcAddr, EndpointAddress dstAddr)
processIncomingMessage
in interface EndpointListener
message
- Incoming messagesrcAddr
- Endpoint Address of the source of the message.dstAddr
- Endpoint Address of the destination of the message.public Message addCryptoInfo(Message submessage, EndpointAddress destAddress) throws IOException
submessage
- the messagedestAddress
- the destination
IOException
public Message checkCryptoInfo(Message message, MessageElement cryptoElement, CbJxMessageInfo cryptoInfo)
|
JXSE | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |