Project JXTA

Deprecated API


Contents
Deprecated Interfaces
net.jxta.endpoint.EndpointFilterListener
          See the MessageFilterListener. 
net.jxta.credential.PrivledgedOperation
          Due to a spelling error, this class is being replaced with PrivilegedOperation. 
net.jxta.util.TimeStampedData
          Will be deprecated soon and moved to impl utils. 
 

Deprecated Classes
net.jxta.util.AbstractTimeStampedData
          Will be deprecated soon and moved to impl utils. 
net.jxta.util.AdvertisementUtilities
          Will be deprecated soon. Do not use these methods. They contain a number of incorrect assumption that cannot be corrected while maintaining backwards compatibility with programs which already use them. 
net.jxta.util.DocumentUtilities
          Will be removed soon. 
net.jxta.util.GenericTimeStampedData
          Will be deprecated soon and moved to impl utils. 
net.jxta.util.MessageUtilities
          These utilities are unsupported and known to have problems. They are not reccommended for use and will be removed in a future JXTA release. 
net.jxta.util.ServiceUtilities
          This class will be removed soon. 
net.jxta.util.endpoint.WeakMessengerCache
          The new endpoint implemenation introduced in JXTA J2SE 2.3 makes this cache largely unnecessary. It should not be used in new code. 
 

Deprecated Fields
net.jxta.endpoint.Message.modifiable
          You really should not depend on this feature. 
 

Deprecated Methods
net.jxta.rendezvous.RendezVousService.addPropagateListener(String, EndpointListener)
          The naming convention is contrary to the more recent usage of specifying listeners with separate serviceName and serviceParam. Prefer RendezVousService.addPropagateListener(String, String, EndpointListener). 
net.jxta.util.AdvertisementUtilities.advertisementToBytes(Advertisement)
          This method should not be used because it produces a result who's encoding is not predictable and may (will) differ from JVM to JVM. 
net.jxta.util.AdvertisementUtilities.advertisementToXmlText(Advertisement)
          Equivalent to Advertisement.toString() 
net.jxta.util.AdvertisementUtilities.bytesToAdvertisement(byte[])
          This method should not be used because it interprets the input using the local default encoding which is not precidcatable and may (will) differ from JVM to JVM. 
net.jxta.endpoint.MessageElement.clone()
          Since Message Elements are immutable this method does nothing useful. 
net.jxta.id.ID.clone()
          IDs are immutable. clone() is never ever needed. 
net.jxta.pipe.PipeService.createMessage()
          Use new Message.Message() instead. 
net.jxta.util.AdvertisementUtilities.createModuleImplAdvertisement(ModuleSpecID, String, String)
          This implementation initializes some fields of the resulting ModuleImplAdvertisement to constant values who's value may not be correct for all circumstances. Consider creating ModuleImpl Advertisements directy in your application. 
net.jxta.util.AdvertisementUtilities.createModuleSpecAdvertisement(String, ModuleClassAdvertisement, StructuredDocument)
          This implementation incompletely initializes the module spec advertisement. Consider creating Module Spec Advertisements without this method. 
net.jxta.util.AdvertisementUtilities.createModuleSpecAdvertisement(String, StructuredDocument)
          This implementation incompletely initializes the module spec advertisement. Consider creating Module Spec Advertisements without this method. 
net.jxta.pipe.PipeService.createOutputPipe(PipeAdvertisement, Enumeration, long)
          Use PipeService.createOutputPipe(PipeAdvertisement, Set, long) instead. 
net.jxta.pipe.PipeService.createOutputPipe(PipeAdvertisement, PeerID, long)
          Use PipeService.createOutputPipe(PipeAdvertisement, Set, long) with a Collections.singleton(Object) instead. 
net.jxta.pipe.PipeService.createOutputPipe(PipeAdvertisement, PeerID, OutputPipeListener)
          Use PipeService.createOutputPipe(PipeAdvertisement, Set, long) with a Collections.singleton(Object) instead. 
net.jxta.id.IDFactory.fromURL(URL)
          Use of URLs for representing JXTA IDs and this method are deprecated. Convert to using IDFactory.fromURI( URI ) instead. 
net.jxta.id.IDFactory.Instantiator.fromURL(URL)
          Convert to fromURI. 
net.jxta.endpoint.EndpointAddress.getBytes()
          There isn't really ever a good reason to use this since it has to assume the character encoding. 
net.jxta.util.DiscoveryUtilities.getLocalAdvertisement(PeerGroup, String, String)
          Just use discovery directly. This method doesn't seem to do anything useful. 
net.jxta.util.JxtaBiDiPipe.getMessenger()
          use sendMessage instead 
net.jxta.endpoint.EndpointService.getMessenger(EndpointAddress)
          This convenience method adds little value. It is strictly equivalent to getMessenger(addr, null) 
net.jxta.endpoint.EndpointService.getMessenger(MessengerEventListener, EndpointAddress, Object)
          This method is being phased out. Prefer one of the other non-blocking variants. If a listener style paradigm is required, use ListenerAdaptor which emulates this functionality. 
net.jxta.protocol.DiscoveryQueryMsg.getPeerAdv()
          Peer Advertisement is available directly via DiscoveryQueryMsg.getPeerAdvertisement(). 
net.jxta.protocol.DiscoveryResponseMsg.getPeerAdv()
          access peer advertisement directly 
net.jxta.util.AdvertisementUtilities.getPeerAdvertisement(Element)
          These utilities are too specialized for general use. 
net.jxta.util.AdvertisementUtilities.getPipeAdvertisement(Element)
          These utilities are too specialized for general use. 
net.jxta.id.ID.getURL()
          URIs are now the prefered way of manipulating IDs 
net.jxta.endpoint.Messenger.isClosed()
          Use (getState() & USABLE == 0) instead. 
net.jxta.endpoint.Messenger.isIdle()
          no longer relevant and always false. This notably is not equivalent to the Messenger.IDLE state. 
net.jxta.endpoint.Messenger.isSynchronous()
          all messengers are asynchronous, and the Messenger.sendMessageB(net.jxta.endpoint.Message, java.lang.String, java.lang.String) method is always blocking. 
net.jxta.id.IDFactory.jxtaURL(String)
          You should convert code which creates JXTA IDs from strings to instead use IDFactory.fromURI( new URI(String) ). This method was only provided to overcome problems with registration of URL handlers in foreign class loader environments (Servlets, Applets, etc.). 
net.jxta.id.IDFactory.jxtaURL(String, String, String)
          You should convert code which creates JXTA IDs to instead use IDFactory.fromURI( new URI(...) ). This method was only provided to overcome problems with registration of URL handlers in foreign class loader environments (Servlets, Applets, etc.). 
net.jxta.util.AdvertisementUtilities.newAdvertisementFromXml(byte[])
          This method should not be used because it produces a result who's encoding is not predictable and may (will) differ from JVM to JVM. 
net.jxta.util.AdvertisementUtilities.newAdvertisementFromXml(String)
          This method should not be used because it interprets the input using the local default encoding which is not precidcatable and may (will) differ from JVM to JVM. 
net.jxta.endpoint.EndpointService.ping(EndpointAddress)
          It now always return true. Try and get a messenger instead. 
net.jxta.rendezvous.RendezVousService.propagateInGroup(Message, String, String, int, String)
          no need to specify prune peer 
net.jxta.rendezvous.RendezVousService.propagateToNeighbors(Message, String, String, int, String)
          no need to specify prune peer 
net.jxta.discovery.DiscoveryService.publish(Advertisement, int)
          Advertisement type is no longer required to publish an advertisement 
net.jxta.discovery.DiscoveryService.publish(Advertisement, int, long, long)
          Advertisement type is no longer required to publish an advertisement 
net.jxta.discovery.DiscoveryService.remotePublish(Advertisement, int)
          Advertisement type is no longer required to remote publish an advertisement 
net.jxta.discovery.DiscoveryService.remotePublish(Advertisement, int, long)
          Advertisement type is no longer required to remote publish an advertisement 
net.jxta.discovery.DiscoveryService.remotePublish(String, Advertisement, int)
          Advertisement type is no longer required to remote publish an advertisement 
net.jxta.discovery.DiscoveryService.remotePublish(String, Advertisement, int, long)
          Advertisement type is no longer required to remote publish an advertisement 
net.jxta.rendezvous.RendezVousService.removePropagateListener(String, EndpointListener)
          The naming convention is contrary to the more recent usage of specifying listeners with separate serviceName and serviceParam. Prefer RendezVousService.removePropagateListener(String, String, EndpointListener). 
net.jxta.endpoint.AbstractMessenger.sendMessage(Message, String, String, OutgoingMessageEventListener)
          Implements deprecated method. Actual support only provided by channels. 
net.jxta.endpoint.ChannelMessenger.sendMessage(Message, String, String, OutgoingMessageEventListener)
          Implements deprecated method. 
net.jxta.endpoint.Messenger.sendMessage(Message, String, String, OutgoingMessageEventListener)
          This legacy method is being phased out. Prefer Messenger.sendMessageN(net.jxta.endpoint.Message, java.lang.String, java.lang.String) to send messages in a non blocking fashion. 
net.jxta.endpoint.ChannelMessenger.setMessageWatcher(ListenerAdaptor)
          This method is in support of deprecated methods. 
net.jxta.protocol.DiscoveryQueryMsg.setPeerAdv(String)
          access peer advertisement directly 
net.jxta.protocol.DiscoveryResponseMsg.setPeerAdv(String)
          access peer advertisement directly 
net.jxta.endpoint.EndpointAddress.setProtocolAddress(String)
          EndpointAddress works better if it is immutable. 
net.jxta.endpoint.EndpointAddress.setProtocolName(String)
          EndpointAddress works better if it is immutable. 
net.jxta.protocol.DiscoveryResponseMsg.setResponseCount(int)
          Response count is now derived from responses. This call is ignored. 
net.jxta.endpoint.EndpointAddress.setServiceName(String)
          EndpointAddress works better if it is immutable. 
net.jxta.endpoint.EndpointAddress.setServiceParameter(String)
          EndpointAddress works better if it is immutable. 
net.jxta.endpoint.MessageTransport.transportControl(Object, Object)
          Under development, may change. 
 

Deprecated Constructors
net.jxta.endpoint.EndpointAddress()
          EndpointAddress works better if it is immutable. 
net.jxta.endpoint.EndpointAddress(byte[])
          There isn't really ever a good reason to use this since it has to assume the character encoding. 
 


JXTA J2SE