Project JXTA

Uses of Class
net.jxta.exception.PeerGroupException

Packages that use PeerGroupException
net.jxta.membership The Membership Service allows a peer to establish an identity within a peer group.  
net.jxta.peergroup Peer groups are formed as a collection of peers that have agreed upon a common set of services.  
net.jxta.platform Classes for defining code modules within JXTA.  
 

Uses of PeerGroupException in net.jxta.membership
 

Methods in net.jxta.membership that throw PeerGroupException
 Authenticator MembershipService.apply(AuthenticationCredential application)
          Request the necessary credentials to join the group with which this service is associated.
 Credential MembershipService.join(Authenticator authenticated)
          Join the group by virtue of the completed authentication provided.
 void MembershipService.resign()
          Resign all credentials which were previously gained through prior join() operations.
 Credential MembershipService.getDefaultCredential()
          Returns the default credential for this peer.
 Enumeration MembershipService.getCurrentCredentials()
          Returns the current credentials for this peer.
 Enumeration MembershipService.getAuthCredentials()
          Returns the current credentials for this peer.
 Credential MembershipService.makeCredential(Element element)
          Given a fragment of a StructuredDocument, reconstruct a Credential object from that fragment.
 

Uses of PeerGroupException in net.jxta.peergroup
 

Methods in net.jxta.peergroup that throw PeerGroupException
static PeerGroup PeerGroupFactory.newNetPeerGroup(PeerGroup ppg)
          Instantiates the net peer group using the provided platform peer group.
static PeerGroup PeerGroupFactory.newNetPeerGroup()
          Instantiates the platform peergroup and then instantiates the net peer group.
 Module PeerGroup.loadModule(ID assignedID, Advertisement impl)
          Load a module from a ModuleImplAdv.
 PeerGroup PeerGroup.newGroup(Advertisement pgAdv)
          Instantiate a peer group from its given advertisement.
 PeerGroup PeerGroup.newGroup(PeerGroupID gid, Advertisement impl, String name, String description)
          Instantiates a new group from its elementary pieces and publishes the corresponding PeerGroupAdvertisement.
 PeerGroup PeerGroup.newGroup(PeerGroupID gid)
          Instantiate a group from its Peer Group ID only.
 Module LightWeightPeerGroup.loadModule(ID assignedID, Advertisement impl)
          Load a module from a ModuleImplAdv. Compatibility is checked and load is attempted. If compatible and loaded successfuly, the resulting Module is initialized and returned. In most cases the other loadModule() method should be preferred, since unlike this one, it will seek many compatible implementation advertisements and try them all until one works. The home group of the new module (its parent group if the new module is a group) will be this group.
 PeerGroup LightWeightPeerGroup.newGroup(Advertisement pgAdv)
          Instantiate a peer group from its given advertisement. This instantiator requires that the ModuleImplAdvertisment for the peer group and the ModuleImplAdvertisements for the group's services be available for discovery within the current group.

The pgAdv itself may be all new and unpublished. Therefore, the two typical uses of this routine are:

  • Creating an all new group with a new ID while using an existing and published implementation. (Possibly a new one published for that purpose). The information should first be gathered in a new PeerGroupAdvertisement which is then passed to this method.
  • Instantiating a group which advertisement has already been discovered (therefore there is no need to find it by groupID again).

To create a group from a known implAdv, use PeerGroup.newGroup(PeerGroupID,Advertisement,String,String)

 PeerGroup LightWeightPeerGroup.newGroup(PeerGroupID gid, Advertisement impl, String name, String description)
          Instantiates a new group from its elementary pieces and publishes the corresponding PeerGroupAdvertisement. The pieces are: the groups implementation adv, the group id, the name and description.

The typical use of this routine is creating a whole new group based on a newly created and possibly unpublished implementation adv.

This is a convenience method equivalent to either:

 newGrp = thisGroup.loadModule(gid, impl);
 newGrp.publishGroup(name, description);
 

or, but only if the implementation advertisement has been published:

 newPGAdv = AdvertisementFactory.newAdvertisement(
                 PeerGroupAdvertisement.getAdvertisementType());
 newPGAdv.setPeerGroupID(gid);
 newPGAdv.setModuleSpecID(impl.getModuleSpecID());
 newPGAdv.setName(name);
 newPGAdv.setDescription(description);
 newGrp = thisGroup.newGroup(newPGAdv);
 
 PeerGroup LightWeightPeerGroup.newGroup(PeerGroupID gid)
          Instantiate a group from its Peer Group ID only. Use this when using a group that has already been published and discovered.

The typical uses of this routine are therefore:

  • Instantiating a peer group which is assumed to exist and whose Peer Group ID is already known.
  • Creating a new peer group instance using an already published Group advertisement, typically published for that purpose. All other referenced advertisements must also be available.

To create a group from a known implAdv, just use PeerGroup.loadModule(ID,Advertisement) or even:

grp = new GroupSubClass(); grp.init(parentGroup, gid, impladv);

then, REMEMBER TO PUBLISH THE GROUP IF IT IS ALL NEW.

 

Uses of PeerGroupException in net.jxta.platform
 

Methods in net.jxta.platform that throw PeerGroupException
 void Module.init(PeerGroup group, ID assignedID, Advertisement implAdv)
          Initialize the module, passing it its peer group and advertisement.
 


JXTA J2SE