advcooker.html

jxta的api库

</DL>
</DD>
</DL>
<HR>

<A NAME="printNewClassAndModuleID(net.jxta.platform.ModuleClassID)"><!-- --></A><H3>
printNewClassAndModuleID</H3>
<PRE>
public static void <B>printNewClassAndModuleID</B>(<A HREF="../../../../net/jxta/platform/ModuleClassID.html" title="class in net.jxta.platform">ModuleClassID</A>&nbsp;baseClassID)</PRE>
<DL>
<DD>Use this form if your module is a custom implementation of a well-known
 module such as RendezvousServiceImpl. The class id's of well-known
 modules are static members of net.jxta.peergroup.PeerGroup, e.g.,
 PeerGroup.rendezvousClassID.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>baseClassID</CODE> - --the class ID of the module to customized, e.g.
 that of RendezvousServiceImpl.</DL>
</DD>
</DL>
<HR>

<A NAME="buildModuleClassID(java.lang.String)"><!-- --></A><H3>
buildModuleClassID</H3>
<PRE>
public static <A HREF="../../../../net/jxta/platform/ModuleClassID.html" title="class in net.jxta.platform">ModuleClassID</A> <B>buildModuleClassID</B>(java.lang.String&nbsp;url)
                                        throws java.net.MalformedURLException,
                                               java.net.UnknownServiceException</PRE>
<DL>
<DD>Reconstructs a ModuleClassID from its String representation
 as printed by the foregoing recipes.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>url</CODE> - -- the module class id in String form, "urn:jxta:uuid-[the big hex string]"
<DT><B>Returns:</B><DD>-- module class id reconstructed from String
<DT><B>Throws:</B>
<DD><CODE>MalformedURLException</CODE> - -- if url is messed up
<DD><CODE>UnknownServiceException</CODE> - --if urn: isn't supported, meaning a jar is missing</DL>
</DD>
</DL>
<HR>

<A NAME="buildModuleSpecID(java.lang.String)"><!-- --></A><H3>
buildModuleSpecID</H3>
<PRE>
public static <A HREF="../../../../net/jxta/platform/ModuleSpecID.html" title="class in net.jxta.platform">ModuleSpecID</A> <B>buildModuleSpecID</B>(java.lang.String&nbsp;url)
                                      throws java.net.MalformedURLException,
                                             java.net.UnknownServiceException</PRE>
<DL>
<DD>Reconstructs a ModuleSpecID from its String representation
 as printed by the foregoing recipes.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>url</CODE> - -- the module spec id in String form, "urn:jxta:uuid-[the big hex string]"
<DT><B>Returns:</B><DD>-- module spec id reconstructed from String
<DT><B>Throws:</B>
<DD><CODE>MalformedURLException</CODE> - -- if url is messed up
<DD><CODE>UnknownServiceException</CODE> - --if urn: isn't supported, meaning a jar is missing</DL>
</DD>
</DL>
<HR>

<A NAME="buildModuleClassAdvertisement(net.jxta.platform.ModuleClassID, java.lang.String, java.lang.String)"><!-- --></A><H3>
buildModuleClassAdvertisement</H3>
<PRE>
public static <A HREF="../../../../net/jxta/protocol/ModuleClassAdvertisement.html" title="class in net.jxta.protocol">ModuleClassAdvertisement</A> <B>buildModuleClassAdvertisement</B>(<A HREF="../../../../net/jxta/platform/ModuleClassID.html" title="class in net.jxta.platform">ModuleClassID</A>&nbsp;mcid,
                                                                     java.lang.String&nbsp;serviceName,
                                                                     java.lang.String&nbsp;serviceDescription)</PRE>
<DL>
<DD>The module class advertisement is to simply advertise the
 existence of a module.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>mcid</CODE> - -- the module class id<DD><CODE>serviceName</CODE> - -- something like "JXTAMOD:JXTA-WIRE-MyNewThing"<DD><CODE>serviceDescription</CODE> - -- something like "JXTA-WIRE MyNewThing Module"
<DT><B>Returns:</B><DD>an appropriate ModuleClassAdvertisement</DL>
</DD>
</DL>
<HR>

<A NAME="buildModuleSpecAdvertisement(net.jxta.platform.ModuleSpecID, java.lang.String, java.lang.String)"><!-- --></A><H3>
buildModuleSpecAdvertisement</H3>
<PRE>
public static <A HREF="../../../../net/jxta/protocol/ModuleSpecAdvertisement.html" title="class in net.jxta.protocol">ModuleSpecAdvertisement</A> <B>buildModuleSpecAdvertisement</B>(<A HREF="../../../../net/jxta/platform/ModuleSpecID.html" title="class in net.jxta.platform">ModuleSpecID</A>&nbsp;msid,
                                                                   java.lang.String&nbsp;moduleSpecName,
                                                                   java.lang.String&nbsp;moduleSpecDescription)</PRE>
<DL>
<DD>The ModuleSpecAdvertisement has two purposes, to publish
 the uri of its formal specs for developers and to publish the
 means of remote access to the module's services if that
 is appropriate. (See <A HREF="../../../../net/jxta/protocol/ModuleSpecAdvertisement.html" title="class in net.jxta.protocol"><CODE>ModuleSpecAdvertisement</CODE></A> )
 Use this form for a minimal advertisement, suitable
 for development.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>msid</CODE> - -- the module spec id, "urn:jxta:uuid-[the big hex string]"<DD><CODE>moduleSpecName</CODE> - -- something like "JXTASPEC:JXTA-WIRE-MyNewThing-SPEC"<DD><CODE>moduleSpecDescription</CODE> - -- something like "JXTA-WIRE MyNewThing Specification"
<DT><B>Returns:</B><DD>-- a boilerplate suitable for development.</DL>
</DD>
</DL>
<HR>

<A NAME="buildModuleSpecAdvertisement(net.jxta.platform.ModuleSpecID, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)"><!-- --></A><H3>
buildModuleSpecAdvertisement</H3>
<PRE>
public static <A HREF="../../../../net/jxta/protocol/ModuleSpecAdvertisement.html" title="class in net.jxta.protocol">ModuleSpecAdvertisement</A> <B>buildModuleSpecAdvertisement</B>(<A HREF="../../../../net/jxta/platform/ModuleSpecID.html" title="class in net.jxta.platform">ModuleSpecID</A>&nbsp;msid,
                                                                   java.lang.String&nbsp;moduleSpecName,
                                                                   java.lang.String&nbsp;moduleSpecDescription,
                                                                   java.lang.String&nbsp;creator,
                                                                   java.lang.String&nbsp;version,
                                                                   java.lang.String&nbsp;specURI)</PRE>
<DL>
<DD>Use this form for production provided remote access is not required.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>msid</CODE> - -- the module spec id, "urn:jxta:uuid-[the big hex string]"<DD><CODE>moduleSpecName</CODE> - -- something like "JXTASPEC:JXTA-WIRE-MyNewThing-SPEC"<DD><CODE>moduleSpecDescription</CODE> - -- something like "JXTA-WIRE MyNewThing Specification"<DD><CODE>creator</CODE> - -- something like "jxta.org"<DD><CODE>version</CODE> - -- something like "Version 1.0"<DD><CODE>specURI</CODE> - -- where to locate the formal specs, e.g. "http://www.jxta.org/MyNewThing"
<DT><B>Returns:</B><DD>-- a fully populated advert suitable if remote access is not required.</DL>
</DD>
</DL>
<HR>

<A NAME="buildModuleSpecAdvertisement(net.jxta.platform.ModuleSpecID, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, net.jxta.protocol.PipeAdvertisement, net.jxta.platform.ModuleSpecID, net.jxta.platform.ModuleSpecID, net.jxta.document.StructuredDocument)"><!-- --></A><H3>
buildModuleSpecAdvertisement</H3>
<PRE>
public static <A HREF="../../../../net/jxta/protocol/ModuleSpecAdvertisement.html" title="class in net.jxta.protocol">ModuleSpecAdvertisement</A> <B>buildModuleSpecAdvertisement</B>(<A HREF="../../../../net/jxta/platform/ModuleSpecID.html" title="class in net.jxta.platform">ModuleSpecID</A>&nbsp;msid,
                                                                   java.lang.String&nbsp;moduleSpecName,
                                                                   java.lang.String&nbsp;moduleSpecDescription,
                                                                   java.lang.String&nbsp;creator,
                                                                   java.lang.String&nbsp;version,
                                                                   java.lang.String&nbsp;specURI,
                                                                   <A HREF="../../../../net/jxta/protocol/PipeAdvertisement.html" title="class in net.jxta.protocol">PipeAdvertisement</A>&nbsp;pipeAdv,
                                                                   <A HREF="../../../../net/jxta/platform/ModuleSpecID.html" title="class in net.jxta.platform">ModuleSpecID</A>&nbsp;proxySpecID,
                                                                   <A HREF="../../../../net/jxta/platform/ModuleSpecID.html" title="class in net.jxta.platform">ModuleSpecID</A>&nbsp;authorizationSpecID,
                                                                   <A HREF="../../../../net/jxta/document/StructuredDocument.html" title="interface in net.jxta.document">StructuredDocument</A>&nbsp;param)</PRE>
<DL>
<DD>Use this form for a fully populated advert.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>msid</CODE> - -- the module spec id, "urn:jxta:uuid-[the big hex string]"<DD><CODE>moduleSpecName</CODE> - -- something like "JXTASPEC:JXTA-WIRE-MyNewThing-SPEC"<DD><CODE>moduleSpecDescription</CODE> - -- something like "JXTA-WIRE MyNewThing Specification"<DD><CODE>creator</CODE> - -- something like "jxta.org"<DD><CODE>version</CODE> - -- something like "Version 1.0"<DD><CODE>specURI</CODE> - -- where to locate the formal specs, e.g. "http://www.jxta.org/MyNewThing"<DD><CODE>pipeAdv</CODE> - -- to make the module useable remotely (see <A HREF="../../../../net/jxta/protocol/ModuleSpecAdvertisement.html" title="class in net.jxta.protocol"><CODE>ModuleSpecAdvertisement</CODE></A>)<DD><CODE>proxySpecID</CODE> - -- sometimes required for remote use (see <A HREF="../../../../net/jxta/protocol/ModuleSpecAdvertisement.html" title="class in net.jxta.protocol"><CODE>ModuleSpecAdvertisement</CODE></A>)<DD><CODE>authorizationSpecID</CODE> - -- sometimes required for remote use (see <A HREF="../../../../net/jxta/protocol/ModuleSpecAdvertisement.html" title="class in net.jxta.protocol"><CODE>ModuleSpecAdvertisement</CODE></A>)<DD><CODE>param</CODE> - -- anything else
<DT><B>Returns:</B><DD>-- a fully populated advert specifying remote access to module services.</DL>
</DD>
</DL>
<HR>

<A NAME="buildCompat()"><!-- --></A><H3>
buildCompat</H3>
<PRE>
public static <A HREF="../../../../net/jxta/document/StructuredTextDocument.html" title="interface in net.jxta.document">StructuredTextDocument</A> <B>buildCompat</B>()</PRE>
<DL>
<DD>Compat's (compatibility statements) serve to narrow the search
  for a ModuleImplAdvertisement. Basically you want something
  compatible with your group's implementation. Use this form for
  compatibilty with the current StdPeerGroup.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>-- boilerplate compat for StdPeerGroup</DL>
</DD>
</DL>
<HR>

<A NAME="buildCompat(java.lang.String, java.lang.String)"><!-- --></A><H3>
buildCompat</H3>
<PRE>
public static <A HREF="../../../../net/jxta/document/StructuredTextDocument.html" title="interface in net.jxta.document">StructuredTextDocument</A> <B>buildCompat</B>(java.lang.String&nbsp;efmt,
                                                 java.lang.String&nbsp;bind)</PRE>
<DL>
<DD>Use this form for customized compatibility statements.
 Alternatively a group's compat is accessible via
 group.getCompat()
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>efmt</CODE> - -- something like "JDK1.4"<DD><CODE>bind</CODE> - -- something like "V1.0 Ref Impl"
<DT><B>Returns:</B><DD>-- custom compatibility tag</DL>
</DD>
</DL>
<HR>

<A NAME="buildModuleImplAdvertisement(net.jxta.platform.ModuleSpecID, java.lang.String, net.jxta.document.Element)"><!-- --></A><H3>
buildModuleImplAdvertisement</H3>
<PRE>
public static <A HREF="../../../../net/jxta/protocol/ModuleImplAdvertisement.html" title="class in net.jxta.protocol">ModuleImplAdvertisement</A> <B>buildModuleImplAdvertisement</B>(<A HREF="../../../../net/jxta/platform/ModuleSpecID.html" title="class in net.jxta.platform">ModuleSpecID</A>&nbsp;msid,
                                                                   java.lang.String&nbsp;code,
                                                                   <A HREF="../../../../net/jxta/document/Element.html" title="interface in net.jxta.document">Element</A>&nbsp;compat)</PRE>
<DL>
<DD>A ModuleImplAdvertisement represents one of any number of
 published implementations of a given specification. Use this form
 with for a development boilerplate. Use buildCompat() for a compat
 boilerplate.
 (See <A HREF="../../../../net/jxta/protocol/ModuleImplAdvertisement.html" title="class in net.jxta.protocol"><CODE>ModuleImplAdvertisement</CODE></A>.)
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>msid</CODE> - -- the module spec id<DD><CODE>code</CODE> - -- the module's fully qualified classname, "net.jxta.impl.wire.MyNewThing"<DD><CODE>compat</CODE> - -- a compatibility statement. Use buildCompat() for a boilerplate.