JXTA

Deprecated API


Contents
Deprecated Interfaces
net.jxta.peergroup.Configurator
          This interface has been replaced with the NetworkConfigurator. 
net.jxta.resolver.GenericResolver
          This interface has been subsumed into the ResolverService. 
net.jxta.id.IDFactory.URIInstantiator
          This interface formerly contained optional URI based construction methods. These have now been moved to the primary instantiator interface in preparation for the removal of the URL based interfaces. This interface will be removed in a future release. 
net.jxta.util.WatchedStream
          This class is no longer used by the JXTA core and should not have been part of the public JXTA API. If you use it, copy it to your own source base. It will be deleted after June 2007 release. 
 

Deprecated Classes
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. THIS CLASS IS SCHEDULED TO BE REMOVED AFTER 2.5 
net.jxta.util.DocumentUtilities
          Will be removed soon. THIS CLASS IS SCHEDULED TO BE REMOVED AFTER 2.5 
net.jxta.util.MessageUtilities
          These utilities are unsupported and known to have problems. They are not recommended for use and will be removed in a future JXTA release THIS CLASS IS SCHEDULED TO BE REMOVED AFTER 2.5. 
net.jxta.peergroup.PeerGroupFactory
          This factory has been deprecated in favour of WorldPeerGroupFactory and NetPeerGroupFactory. See the deprecations for the individual methods for the specific replacements/alternatives provided by the new factory classes. 
net.jxta.protocol.RouteQueryMsg
          This class will be removed from the public JXTA API. It is used only by the standard router message transport implementation and is of no use to applications. 
net.jxta.protocol.RouteResponseMsg
          This message is private to the Endpoint Router implementation and not part of the JXTA public API. It will be moved from this package. 
net.jxta.util.WatchedInputStream
          This class is no longer used by the JXTA core and should not have been part of the public JXTA API. If you use it, copy it to your own source base. It will be deleted after June 2007 release. 
net.jxta.util.WatchedOutputStream
          This class is no longer used by the JXTA core and should not have been part of the public JXTA API. If you use it, copy it to your own source base. It will be deleted after June 2007 release. 
 

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

Deprecated Methods
net.jxta.protocol.RouteAdvertisement.addDestEndpointAddresses(Vector)
          Use #addDestEndpointAddresses(List) instead. 
net.jxta.protocol.AccessPointAdvertisement.addEndpointAddresses(Vector)
          Use AccessPointAdvertisement.addEndpointAddresses(List) instead. 
net.jxta.rendezvous.RendezVousService.addPropagateListener(String, String, EndpointListener)
          This method just calls EndpointService.addIncomingMessageListener(net.jxta.endpoint.EndpointListener, java.lang.String, java.lang.String). It's better to just register your listener with the Endpoint. This call may be eventually removed. 
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 predictable and may (will) differ from JVM to JVM. 
net.jxta.platform.NetworkConfigurator.clearRendezvousSeedURIs()
          The name of this method is inconsistent with it's function! It clears the seeding URIs and not the seed URIs. Use NetworkConfigurator.clearRendezvousSeedingURIs() instead. 
net.jxta.endpoint.EndpointAddress.clone()
          EndpointAddress objects are immutable and never need to be cloned. 
net.jxta.endpoint.MessageElement.clone()
          Since Message Elements are immutable this method does nothing useful. 
net.jxta.rendezvous.RendezVousService.connectToRendezVous(EndpointAddress)
          Directly connecting to rendezvous peers is not recommended. Seed rendezvous should be specified using the RdvConfigAdv mechanisms. 
net.jxta.rendezvous.RendezVousService.connectToRendezVous(PeerAdvertisement)
          Directly connecting to rendezvous peers is not recommended. Seed rendezvous should be specified using the RdvConfigAdv mechanisms. 
net.jxta.socket.JxtaSocket.create(boolean)
          Unreliable mode is being removed. Use JxtaBiDiPipe 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 directly 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.endpoint.EndpointService.demux(Message)
          Please convert your code to use the EndpointListener.processIncomingMessage(Message,EndpointAddress,EndpointAddress) method instead. The addressing method used by demux() was never part of the formal JXTA protocol specification but was a defacto part because demux() depended upon it. 
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.membership.MembershipService.getAuthCredentials()
          This interface is being removed in favour of individual Credentials providing their AuthenticationCredential as appropriate. 
net.jxta.peergroup.PeerGroupFactory.getConfiguratorClass()
          Consider converting to use NetPeerGroupFactory. 
net.jxta.protocol.RouteAdvertisement.getDest()
          Because this method unsafely exposes destination AccessPointAdvertisement it will be removed. 
net.jxta.endpoint.Messenger.getDestinationAddressObject()
          EndpointAddress is now immutable which means that this result is the same as Messenger.getDestinationAddress(). This method will be eventually removed. 
net.jxta.endpoint.AbstractMessenger.getDestinationAddressObject()
           
net.jxta.rendezvous.RendezVousService.getDisconnectedRendezVous()
          Due to design changes this no longer returns accurate nor complete results. It will eventually be removed. 
net.jxta.util.JxtaBiDiPipe.getListener()
          use getMessageListener instead 
net.jxta.rendezvous.RendezVousService.getLocalWalkView()
          Due to design changes, the list of peers may be empty in configurations which previously returned a non-empty result. Future JXTA versions are likely to use a different API. 
net.jxta.socket.JxtaSocket.getMaxRetryTimeout()
          The reliability layer manages it's own maximum. This value is not useful. 
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.socket.JxtaSocket.getOutputStreamBufferSize()
          Use the standard JxtaSocket.getSendBufferSize() method instead. 
net.jxta.protocol.DiscoveryQueryMsg.getPeerAdv()
          Peer Advertisement is available directly via DiscoveryQueryMsg.getPeerAdvertisement(). 
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.protocol.ConfigParams.getServiceParamsEntrySet()
          This method exposes the internal data structures of the advertisement and will be removed in order to prevent unexpected behaviour. 
net.jxta.protocol.ResolverQueryMsg.getSrc()
          Use ResolverQueryMsg.getSrcPeer() instead. 
net.jxta.peergroup.PeerGroupFactory.getStoreHome()
          Consider converting to use NetPeerGroupFactory and/or WorldPeerGroupFactory. 
net.jxta.protocol.SrdiMessage.getTTL()
          ttl is a misnomer, it is meant to be defined as scope. use #getScope() instead 
net.jxta.id.ID.getURL()
          URIs are now the preferred way of manipulating IDs 
net.jxta.protocol.AccessPointAdvertisement.getVectorEndpointAddresses()
          Returning the Vector is dangerous and unwise. This feature will be removed. 
net.jxta.endpoint.Messenger.isIdle()
          no longer relevant and always false. This notably is not equivalent to the Messenger.IDLE state. 
net.jxta.endpoint.AbstractMessenger.isIdle()
           
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.endpoint.AbstractMessenger.isSynchronous()
           
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, JNLP, 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, JNLP, etc.). 
net.jxta.peergroup.Configurator.load()
          Loading of existing configuration is best accomplished by use of specific constructors of the implementing configurator. This method complicates the state management of configuration parameters and may have unpredictable results depending upon the constructor and configuration set methods used prior to it's execution. 
net.jxta.document.AdvertisementFactory.newAdvertisement(MimeMediaType, InputStream)
          Please convert your code to construct an XMLDocument using StructuredDocumentFactory and then call AdvertisementFactory.newAdvertisement(XMLElement). For example :

   XMLDocument xml = (XMLDocument) StructuredDocumentFactory.newStructuredDocument( MimeMediaType.XMLUTF8, is );
 
or frequently:

   XMLDocument xml = (XMLDocument) StructuredDocumentFactory.newStructuredDocument( msgElement );
 
followed by:

   Advertisement adv = AdvertisementFactory.newAdvertisement(xml);
 
 
net.jxta.document.AdvertisementFactory.newAdvertisement(MimeMediaType, Reader)
          Please convert your code to construct an XMLDocument using StructuredDocumentFactory and then call AdvertisementFactory.newAdvertisement(XMLElement). For example :

   XMLDocument xml = (XMLDocument) StructuredDocumentFactory.newStructuredDocument( MimeMediaType.XMLUTF8, reader );
 
or frequently:

   XMLDocument xml = (XMLDocument) StructuredDocumentFactory.newStructuredDocument( msgElement );
 
followed by:

   Advertisement adv = AdvertisementFactory.newAdvertisement(xml);
 
 
net.jxta.document.AdvertisementFactory.newAdvertisement(TextElement)
          Advertisements must be encoded in XML. This is a legacy static constructor. You should convert your code to use the XMLElement version. 
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.peergroup.PeerGroupFactory.newNetPeerGroup()
          Consider converting to use NetPeerGroupFactory.NetPeerGroupFactory() or preferably one of the other NetPeerGroupFactory constructors. 
net.jxta.peergroup.PeerGroupFactory.newNetPeerGroup(PeerGroup)
          Consider converting to use NetPeerGroupFactory.NetPeerGroupFactory(PeerGroup,ID,String,XMLElement). 
net.jxta.peergroup.PeerGroupFactory.newPeerGroup()
          This method was previously unused and has been removed with no alternatives. (it wasn't useful) 
net.jxta.peergroup.PeerGroupFactory.newPlatform()
          Consider converting to use WorldPeerGroupFactory.WorldPeerGroupFactory(). 
net.jxta.endpoint.MessageSender.ping(EndpointAddress)
          This operation is often very expensive and usually duplicates the work of MessageSender.getMessenger(net.jxta.endpoint.EndpointAddress, java.lang.Object). If you want to determine the reachability of a destination, get a Messenger to the destination. 
net.jxta.endpoint.EndpointService.ping(EndpointAddress)
          The cost of performing this operation is generally the same as getting a Messenger for the destination. Using getMessenger() is a better approach because the resulting Messenger is generally needed soon after ping. 
net.jxta.protocol.RouteAdvertisement.removeDestEndpointAddresses(Vector)
          Use RouteAdvertisement.removeDestEndpointAddresses(Collection). 
net.jxta.pipe.PipeService.removeOutputPipeListener(String, OutputPipeListener)
          This method is being replaced by PipeService.removeOutputPipeListener(ID,OutputPipeListener). 
net.jxta.rendezvous.RendezVousService.removePropagateListener(String, String, EndpointListener)
          This method just calls EndpointService.removeIncomingMessageListener(java.lang.String, java.lang.String). It's better to just deregister your listener with the Endpoint. This call may be eventually removed. 
net.jxta.peergroup.Configurator.setConfigParams(ConfigParams)
          Configuration parameters should be set individually via whatever interfaces implementing configurator provides. This method over-writes all configuration settings in an unpredictable way. 
net.jxta.peergroup.PeerGroupFactory.setConfiguratorClass(Class)
          Consider converting to use NetPeerGroupFactory and/or WorldPeerGroupFactory. 
net.jxta.protocol.RouteAdvertisement.setDestEndpointAddresses(Vector)
          Use RouteAdvertisement.addDestEndpointAddress(EndpointAddress) instead. 
net.jxta.protocol.AccessPointAdvertisement.setEndpointAddresses(Vector)
          This method causes the AccessPointAdvertisement to reference the provided array. This means that subsequent changes to the array will alter the endpoint addresses which are part of the AcccessPointAdvertisement. 
net.jxta.util.JxtaBiDiPipe.setListener(PipeEventListener)
          use setPipeEventListener instead 
net.jxta.util.JxtaBiDiPipe.setListener(PipeMsgListener)
          use setMessageListener instead 
net.jxta.socket.JxtaSocket.setMaxRetryTimeout(int)
          The reliability layer manages it's own maximum. This value is not useful. 
net.jxta.peergroup.PeerGroupFactory.setNetPGDesc(String)
          Consider converting to use NetPeerGroupFactory.NetPeerGroupFactory(ConfigParams,URI,ID,String,XMLElement) or NetPeerGroupFactory.NetPeerGroupFactory(PeerGroup,ID,String,XMLElement). 
net.jxta.peergroup.PeerGroupFactory.setNetPGID(PeerGroupID)
          Consider converting to use NetPeerGroupFactory.NetPeerGroupFactory(ConfigParams,URI,ID,String,XMLElement) or NetPeerGroupFactory.NetPeerGroupFactory(PeerGroup,ID,String,XMLElement). 
net.jxta.peergroup.PeerGroupFactory.setNetPGName(String)
          Consider converting to use NetPeerGroupFactory.NetPeerGroupFactory(ConfigParams,URI,ID,String,XMLElement) or NetPeerGroupFactory.NetPeerGroupFactory(PeerGroup,ID,String,XMLElement). 
net.jxta.socket.JxtaSocket.setOutputStreamBufferSize(int)
          Use the standard JxtaSocket.setSendBufferSize(int) method instead. 
net.jxta.peergroup.PeerGroupFactory.setPlatformClass(Class)
          Consider converting to use WorldPeerGroupFactory.WorldPeerGroupFactory(Class,ConfigParams,URI). 
net.jxta.platform.NetworkConfigurator.setRendezvousSeedURIs(List)
          The name of this method is inconsistent with it's function! It sets the seeding URIs and not the seed URIs. Use #setRendezvousSeedingURIs() instead. 
net.jxta.protocol.ResolverQueryMsg.setSrc(String)
          Use ResolverQueryMsg.setSrcPeer(ID) instead. 
net.jxta.peergroup.PeerGroupFactory.setStdPeerGroupClass(Class)
          This method previously had no effect and has been removed with no alternatives. 
net.jxta.peergroup.PeerGroupFactory.setStoreHome(URI)
          Consider converting to use NetPeerGroupFactory and/or WorldPeerGroupFactory. 
net.jxta.protocol.SrdiMessage.setTTL(int)
          ttl is a misnomer, it is meant to be defined as scope. use #setScope() instead 
net.jxta.endpoint.MessageTransport.transportControl(Object, Object)
          Under development, may change. 
net.jxta.endpoint.EndpointAddress.unmodifiableEndpointAddress(EndpointAddress)
          All EndpointAddresses are now unmodifiable so this method is no longer needed. 
 

Deprecated Constructors
net.jxta.socket.JxtaSocketAddress(PeerGroupID, PipeAdvertisement)
          use the PeerAdvertisement variant instead 
net.jxta.socket.JxtaSocketAddress(PeerGroupID, PipeAdvertisement, PeerID)
          use the PeerAdvertisement variant instead 
net.jxta.socket.JxtaSocketAddress(PeerGroup, PipeAdvertisement, PeerID)
          use the PeerAdvertisement variant instead 
net.jxta.peergroup.NetPeerGroupFactory(ConfigParams, URI, ID, String, XMLElement)
          With the addition of support for PeerGroupConfigAdv this constructor is being deprecated as the precedence of settings is ambiguous. 
net.jxta.peergroup.NetPeerGroupFactory(PeerGroup, ID, String, XMLElement)
          With the addition of support for PeerGroupConfigAdv this constructor is being deprecated as the precedence of settings is ambiguous. 
net.jxta.peergroup.NetPeerGroupFactory(PeerGroup, ID, String, XMLElement, ModuleImplAdvertisement)
          With the addition of support for PeerGroupConfigAdv this constructor is being deprecated as the precedence of settings is ambiguous. 
 


JXSE