You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@river.apache.org by bu...@apache.org on 2010/12/24 23:02:04 UTC
svn commit: r781583 [4/10] -
/websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/
Added: websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/NonActivatableServiceDescriptor.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/NonActivatableServiceDescriptor.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/NonActivatableServiceDescriptor.html Fri Dec 24 22:02:03 2010
@@ -0,0 +1,903 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:07 EST 2010 -->
+<TITLE>
+NonActivatableServiceDescriptor (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="com.sun.jini.start.NonActivatableServiceDescriptor class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="NonActivatableServiceDescriptor (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/NonActivatableServiceDescriptor.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../com/sun/jini/start/LoaderSplitPolicyProvider.html" title="class in com.sun.jini.start"><B>PREV CLASS</B></A>
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.Created.html" title="class in com.sun.jini.start"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?com/sun/jini/start/NonActivatableServiceDescriptor.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="NonActivatableServiceDescriptor.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: <A HREF="#nested_class_summary">NESTED</A> | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+com.sun.jini.start</FONT>
+<BR>
+Class NonActivatableServiceDescriptor</H2>
+<PRE>
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>com.sun.jini.start.NonActivatableServiceDescriptor</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../com/sun/jini/start/ServiceDescriptor.html" title="interface in com.sun.jini.start">ServiceDescriptor</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/Serializable.html" title="class or interface in java.io">Serializable</A></DD>
+</DL>
+<DL>
+<DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../../com/sun/jini/start/SharedActivatableServiceDescriptor.html" title="class in com.sun.jini.start">SharedActivatableServiceDescriptor</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public class <B>NonActivatableServiceDescriptor</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A><DT>implements <A HREF="../../../../com/sun/jini/start/ServiceDescriptor.html" title="interface in com.sun.jini.start">ServiceDescriptor</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/Serializable.html" title="class or interface in java.io">Serializable</A></DL>
+</PRE>
+
+<P>
+Class used to launch shared, non-activatable, in-process
+ services. Clients construct this object with the details
+ of the service to be launched, then call
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#create(net.jini.config.Configuration)"><CODE>create(Configuration config) </CODE></A>
+ to launch the service in the invoking object's VM.
+ <P>
+ This class provides separation of the import codebase
+ (where the service implementation classes are loaded from)
+ from the export codebase
+ (where service clients should load classes from, for example stubs).
+ as well as providing an independent security policy file for each
+ service object. This functionality allows multiple service objects
+ to be placed in the same VM, with each object maintaining distinct
+ export codebase and security policy settings.
+ <P>
+ <a name="serviceConstructor">
+ Services need to implement the following "non-activatable
+ constructor":
+ <blockquote><pre><impl>(String[] args, <A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start"><CODE>LifeCycle</CODE></A> lc)</blockquote></pre>
+ where,
+ <UL>
+ <LI>args - are the service configuration arguments
+ <LI>lc - is the hosting environment's
+ <A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start"><CODE>LifeCycle</CODE></A> reference.
+ </UL>
+
+ <a name="serviceProxy">
+ A service implementation can return its service proxy
+ (via the <code>proxy</code> field of the
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.Created.html" title="class in com.sun.jini.start"><CODE>Created</CODE></A> object returned by
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#create(net.jini.config.Configuration)"><CODE>create</CODE></A>)
+ in the following order of precedence:
+ <OL>
+ <LI> if the service class implements
+ <A HREF="../../../../com/sun/jini/start/ServiceProxyAccessor.html" title="interface in com.sun.jini.start"><CODE>ServiceProxyAccessor</CODE></A> then return value of
+ <A HREF="../../../../com/sun/jini/start/ServiceProxyAccessor.html#getServiceProxy()"><CODE>getServiceProxy</CODE></A>
+ will be used as the service proxy.
+ <LI> if the service class implements
+ <A HREF="../../../../net/jini/export/ProxyAccessor.html" title="interface in net.jini.export"><CODE>ProxyAccessor</CODE></A>
+ then the return value of
+ <A HREF="../../../../net/jini/export/ProxyAccessor.html#getProxy()"><CODE>getProxy</CODE></A> will be used
+ as the service proxy.
+ <LI> Otherwise <code>null</code> will be returned as the service proxy.
+ </OL>
+
+ The following items are discussed below:
+ <ul>
+ <li><a href="#configEntries">Configuring NonActivatableServiceDescriptor</a>
+ <li><a href="#logging">Logging</a>
+ </ul>
+
+ <a name="configEntries">
+ <h3>Configuring NonActivatableServiceDescriptor</h3>
+ </a>
+
+ <code>NonActivatableServiceDescriptor</code>
+ depends on <A HREF="../../../../com/sun/jini/start/ActivateWrapper.html" title="class in com.sun.jini.start"><CODE>ActivateWrapper</CODE></A>, which can itself be configured. See
+ <A HREF="../../../../com/sun/jini/start/ActivateWrapper.html" title="class in com.sun.jini.start">ActivateWrapper</A>'s
+ <A HREF="ActivateWrapper.html#configEntries">configuration</A>
+ information for details.
+<p>
+ This implementation obtains its configuration entries from the
+ <A HREF="../../../../net/jini/config/Configuration.html" title="interface in net.jini.config"><CODE>Configuration</CODE></A> object passed into
+ the <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#create(net.jini.config.Configuration)"><CODE>create</CODE></A> method.
+ The following configuration entries use the
+ component prefix "<code>com.sun.jini.start</code>": <p>
+
+ <a name="servicePreparer">
+ <table summary="Describes the default service preparer configuration entry"
+ border="0" cellpadding="2">
+ <tr valign="top">
+ <th scope="col" summary="layout"> <font size="+1">•</font>
+ <th scope="col" align="left" colspan="2"> <font size="+1"><code>
+ servicePreparer</code></font>
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Type: <td> <A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security"><CODE>ProxyPreparer</CODE></A>
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Default: <td> <code>
+ new <A HREF="../../../../net/jini/security/BasicProxyPreparer.html" title="class in net.jini.security"><CODE>BasicProxyPreparer</CODE></A>()
+ </code>
+ <tr valign="top"> <td>   <th scope="row" align="right">
+ Description: <td> The default proxy preparer used to prepare
+ the <a href="#serviceProxy">service proxy</a>.
+ This value should not be <code>null</code>. This entry is
+ obtained during the invocation of
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#create(net.jini.config.Configuration)"><CODE>create</CODE></A> and is used
+ to prepare the service proxy returned by
+ the service implementation
+ (see <a href="#serviceProxy">service proxy</a> section for details).
+ This entry is superseded by explicitly passing a
+ <A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security"><CODE>ProxyPreparer</CODE></A> to one of the constructors that
+ accept a <A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security">proxy preparer</A> argument.
+ </table>
+
+ <a name="logging">
+ <h3>Loggers and Logging Levels</h3>
+ </a>
+
+ This implementation uses the <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Logger.html" title="class or interface in java.util.logging"><CODE>Logger</CODE></A>, named
+ <code>com.sun.jini.start.service.starter</code>.
+ The following table describes the
+ type of information logged as well as the levels of information logged.
+ <p>
+
+ <table border="1" cellpadding="5"
+ summary="Describes logging performed by the non-activatable,
+ service descriptor at different logging levels">
+
+ <caption halign="center" valign="top"><b><code>
+ com.sun.jini.start.service.starter</code></b></caption>
+
+ <tr> <th scope="col"> Level <th scope="col"> Description
+
+ <tr> <td> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#SEVERE" title="class or interface in java.util.logging"><CODE>SEVERE</CODE></A> <td>
+ for significant service creation problems
+ <tr> <td> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINER" title="class or interface in java.util.logging"><CODE>FINER</CODE></A> <td>
+ for high level
+ service operation tracing
+ <tr> <td> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/logging/Level.html#FINEST" title="class or interface in java.util.logging"><CODE>FINEST</CODE></A> <td>
+ for low level
+ service operation tracing
+
+ </table> <p>
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>2.0</DD>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../../serialized-form.html#com.sun.jini.start.NonActivatableServiceDescriptor">Serialized Form</A></DL>
+<HR>
+
+<P>
+<!-- ======== NESTED CLASS SUMMARY ======== -->
+
+<A NAME="nested_class_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Nested Class Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static class</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.Created.html" title="class in com.sun.jini.start">NonActivatableServiceDescriptor.Created</A></B></CODE>
+
+<BR>
+ Object returned by
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#create(net.jini.config.Configuration)"><CODE>NonActivatableServiceDescriptor.create()</CODE></A>
+ method that returns the proxy and implementation references
+ for the created service.</TD>
+</TR>
+</TABLE>
+ <!-- =========== FIELD SUMMARY =========== -->
+
+<A NAME="field_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Field Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#descCreated">descCreated</A></B></CODE>
+
+<BR>
+ Flag indicating when create() has been called</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#descCreatedLock">descCreatedLock</A></B></CODE>
+
+<BR>
+ Lock object for <code>descCreated</code> flag</TD>
+</TR>
+</TABLE>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[])">NonActivatableServiceDescriptor</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> policy,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> importCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implClassName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] serverConfigArgs)</CODE>
+
+<BR>
+ Convenience constructor.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[], com.sun.jini.start.LifeCycle)">NonActivatableServiceDescriptor</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> policy,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> importCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implClassName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] serverConfigArgs,
+ <A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start">LifeCycle</A> lifeCycle)</CODE>
+
+<BR>
+ Convenience constructor.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[], com.sun.jini.start.LifeCycle, net.jini.security.ProxyPreparer)">NonActivatableServiceDescriptor</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> policy,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> importCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implClassName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] serverConfigArgs,
+ <A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start">LifeCycle</A> lifeCycle,
+ <A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security">ProxyPreparer</A> preparer)</CODE>
+
+<BR>
+ Main constructor.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[], net.jini.security.ProxyPreparer)">NonActivatableServiceDescriptor</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> policy,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> importCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implClassName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] serverConfigArgs,
+ <A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security">ProxyPreparer</A> preparer)</CODE>
+
+<BR>
+ Convenience constructor.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#create(net.jini.config.Configuration)">create</A></B>(<A HREF="../../../../net/jini/config/Configuration.html" title="interface in net.jini.config">Configuration</A> config)</CODE>
+
+<BR>
+ Attempts to create a service instance based on the service
+ description information provided via constructor parameters.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#getExportCodebase()">getExportCodebase</A></B>()</CODE>
+
+<BR>
+ Codebase accessor method.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#getImplClassName()">getImplClassName</A></B>()</CODE>
+
+<BR>
+ Implementation class accessor method.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#getImportCodebase()">getImportCodebase</A></B>()</CODE>
+
+<BR>
+ Classpath accessor method.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start">LifeCycle</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#getLifeCycle()">getLifeCycle</A></B>()</CODE>
+
+<BR>
+ <code>LifeCycle</code> accessor method.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#getPolicy()">getPolicy</A></B>()</CODE>
+
+<BR>
+ Policy accessor method.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#getServerConfigArgs()">getServerConfigArgs</A></B>()</CODE>
+
+<BR>
+ Service configuration arguments accessor method.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security">ProxyPreparer</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#getServicePreparer()">getServicePreparer</A></B>()</CODE>
+
+<BR>
+ <code>ProxyPreparer</code> accessor method.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#setLifeCycle(com.sun.jini.start.LifeCycle)">setLifeCycle</A></B>(<A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start">LifeCycle</A> lc)</CODE>
+
+<BR>
+ Sets the <code>LifeCycle</code> object for this
+ descriptor.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#setServicePreparer(net.jini.security.ProxyPreparer)">setServicePreparer</A></B>(<A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security">ProxyPreparer</A> serviceProxyPreparer)</CODE>
+
+<BR>
+ Sets the <code>ProxyPreparer</code> for this descriptor.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#toString()">toString</A></B>()</CODE>
+
+<BR>
+ Prints out a field summary</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://
java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ FIELD DETAIL =========== -->
+
+<A NAME="field_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Field Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="descCreated"><!-- --></A><H3>
+descCreated</H3>
+<PRE>
+protected transient boolean <B>descCreated</B></PRE>
+<DL>
+<DD>Flag indicating when create() has been called
+<P>
+<DL>
+</DL>
+</DL>
+<HR>
+
+<A NAME="descCreatedLock"><!-- --></A><H3>
+descCreatedLock</H3>
+<PRE>
+protected transient <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>descCreatedLock</B></PRE>
+<DL>
+<DD>Lock object for <code>descCreated</code> flag
+<P>
+<DL>
+</DL>
+</DL>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[], com.sun.jini.start.LifeCycle, net.jini.security.ProxyPreparer)"><!-- --></A><H3>
+NonActivatableServiceDescriptor</H3>
+<PRE>
+public <B>NonActivatableServiceDescriptor</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> policy,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> importCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implClassName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] serverConfigArgs,
+ <A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start">LifeCycle</A> lifeCycle,
+ <A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security">ProxyPreparer</A> preparer)</PRE>
+<DL>
+<DD>Main constructor. Simply assigns given parameters to
+ their associated, internal fields unless otherwise noted.
+<P>
+<DL>
+<DT><B>Parameters:</B><DD><CODE>exportCodebase</CODE> - location where clients can download required
+ service-related classes (for example, stubs, proxies, etc.).
+ Codebase components must be separated by spaces in which
+ each component is in <code>URL</code> format.<DD><CODE>policy</CODE> - server policy filename or URL<DD><CODE>importCodebase</CODE> - location where server implementation
+ classes can be found.
+ This <code>String</code> assumed (in order) to be either
+ 1) a space delimited set of <code>URL</code>(s)
+ representing a codebase or
+ 2) a <code>File.pathSeparator</code> delimited set
+ of class paths.<DD><CODE>implClassName</CODE> - name of server implementation class<DD><CODE>serverConfigArgs</CODE> - service configuration arguments. This parameter
+ is passed as the <code>String[]</code> argument to the
+ implementation's
+ <a href="#serviceConstructor">constructor</a>.<DD><CODE>lifeCycle</CODE> - <code>LifeCycle</code> reference
+ for hosting environment. This parameter
+ is passed as the <code>LifeCycle</code> argument to the
+ implementation's
+ <a href="#serviceConstructor">constructor</a>. If this argument
+ is null, then a default, no-op <code>LifeCycle</code> object will
+ be assigned.<DD><CODE>preparer</CODE> - <code>ProxyPreparer</code> reference. This object
+ will be used to prepare the service's proxy object, if any
+ (see <a href="#serviceProxy">service proxy</a> section for details).
+ If this argument is null, then the default
+ <a href="#servicePreparer">service preparer</a> will be used.</DL>
+</DL>
+<HR>
+
+<A NAME="NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[], com.sun.jini.start.LifeCycle)"><!-- --></A><H3>
+NonActivatableServiceDescriptor</H3>
+<PRE>
+public <B>NonActivatableServiceDescriptor</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> policy,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> importCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implClassName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] serverConfigArgs,
+ <A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start">LifeCycle</A> lifeCycle)</PRE>
+<DL>
+<DD>Convenience constructor. Equivalent to calling this
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[], com.sun.jini.start.LifeCycle, net.jini.security.ProxyPreparer)"><CODE>contructor</CODE></A>
+ with <code>null</code> for the <code>preparer</code>
+ reference.
+<P>
+</DL>
+<HR>
+
+<A NAME="NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[])"><!-- --></A><H3>
+NonActivatableServiceDescriptor</H3>
+<PRE>
+public <B>NonActivatableServiceDescriptor</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> policy,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> importCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implClassName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] serverConfigArgs)</PRE>
+<DL>
+<DD>Convenience constructor. Equivalent to calling this
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[], com.sun.jini.start.LifeCycle, net.jini.security.ProxyPreparer)"><CODE>contructor</CODE></A>
+ with <code>null</code> for the <code>lifeCycle</code> and <code>preparer</code>
+ references.
+<P>
+</DL>
+<HR>
+
+<A NAME="NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[], net.jini.security.ProxyPreparer)"><!-- --></A><H3>
+NonActivatableServiceDescriptor</H3>
+<PRE>
+public <B>NonActivatableServiceDescriptor</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> exportCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> policy,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> importCodebase,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> implClassName,
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] serverConfigArgs,
+ <A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security">ProxyPreparer</A> preparer)</PRE>
+<DL>
+<DD>Convenience constructor. Equivalent to calling this
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#NonActivatableServiceDescriptor(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String[], com.sun.jini.start.LifeCycle, net.jini.security.ProxyPreparer)"><CODE>contructor</CODE></A>
+ with <code>null</code> for the <code>lifeCycle</code>
+ reference.
+<P>
+</DL>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="getExportCodebase()"><!-- --></A><H3>
+getExportCodebase</H3>
+<PRE>
+public final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getExportCodebase</B>()</PRE>
+<DL>
+<DD>Codebase accessor method.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the export codebase string associated with this service descriptor.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getPolicy()"><!-- --></A><H3>
+getPolicy</H3>
+<PRE>
+public final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getPolicy</B>()</PRE>
+<DL>
+<DD>Policy accessor method.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the policy string associated with this service descriptor.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getImportCodebase()"><!-- --></A><H3>
+getImportCodebase</H3>
+<PRE>
+public final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getImportCodebase</B>()</PRE>
+<DL>
+<DD>Classpath accessor method.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the import codebase string associated with this service descriptor.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getImplClassName()"><!-- --></A><H3>
+getImplClassName</H3>
+<PRE>
+public final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>getImplClassName</B>()</PRE>
+<DL>
+<DD>Implementation class accessor method.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the implementation class string associated with
+ this service descriptor.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getServerConfigArgs()"><!-- --></A><H3>
+getServerConfigArgs</H3>
+<PRE>
+public final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>[] <B>getServerConfigArgs</B>()</PRE>
+<DL>
+<DD>Service configuration arguments accessor method.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the service configuration arguments associated with
+ this service descriptor.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLifeCycle()"><!-- --></A><H3>
+getLifeCycle</H3>
+<PRE>
+public final <A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start">LifeCycle</A> <B>getLifeCycle</B>()</PRE>
+<DL>
+<DD><code>LifeCycle</code> accessor method.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the <code>LifeCycle</code> object associated with
+ this service descriptor.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setLifeCycle(com.sun.jini.start.LifeCycle)"><!-- --></A><H3>
+setLifeCycle</H3>
+<PRE>
+public final void <B>setLifeCycle</B>(<A HREF="../../../../com/sun/jini/start/LifeCycle.html" title="interface in com.sun.jini.start">LifeCycle</A> lc)</PRE>
+<DL>
+<DD>Sets the <code>LifeCycle</code> object for this
+ descriptor. This needs to
+ be called on the service descriptor prior to calling
+ <code>create()</code>. Useful for (re-)setting the
+ the associated <code>LifeCycle</code> upon deserialization
+ of this descriptor.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>lc</CODE> - The <code>LifeCycle</code> object to be
+ associated with this service descriptor.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - if called after <code>create()</code> is invoked</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getServicePreparer()"><!-- --></A><H3>
+getServicePreparer</H3>
+<PRE>
+public final <A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security">ProxyPreparer</A> <B>getServicePreparer</B>()</PRE>
+<DL>
+<DD><code>ProxyPreparer</code> accessor method.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the <code>ProxyPreparer</code> object associated with
+ this service descriptor.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setServicePreparer(net.jini.security.ProxyPreparer)"><!-- --></A><H3>
+setServicePreparer</H3>
+<PRE>
+public final void <B>setServicePreparer</B>(<A HREF="../../../../net/jini/security/ProxyPreparer.html" title="interface in net.jini.security">ProxyPreparer</A> serviceProxyPreparer)</PRE>
+<DL>
+<DD>Sets the <code>ProxyPreparer</code> for this descriptor.
+ This needs to
+ be called on the service descriptor prior to calling
+ <code>create()</code>. Useful for (re-)setting the
+ the associated <code>ProxyPreparer</code> upon deserialization
+ of this descriptor.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>serviceProxyPreparer</CODE> - The <code>ProxyPreparer</code> object to be
+ associated with this service descriptor.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html" title="class or interface in java.lang">IllegalStateException</A></CODE> - if called after <code>create()</code> is invoked</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="create(net.jini.config.Configuration)"><!-- --></A><H3>
+create</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>create</B>(<A HREF="../../../../net/jini/config/Configuration.html" title="interface in net.jini.config">Configuration</A> config)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></PRE>
+<DL>
+<DD>Attempts to create a service instance based on the service
+ description information provided via constructor parameters.
+ <P>
+ This method:
+ <UL>
+ <LI> installs an <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RMISecurityManager.html" title="class or interface in java.rmi"><CODE>RMISecurityManager</CODE></A>
+ if no security manager is already in place
+ <LI> installs an <A HREF="../../../../com/sun/jini/start/AggregatePolicyProvider.html" title="class in com.sun.jini.start"><CODE>AggregatePolicyProvider</CODE></A>
+ as the VM-global policy object
+ (upon the first invocation of this method)
+ <LI> creates an
+ <code>ActivateWrapper.ExportClassLoader</code> with
+ the associated service's import codebase, export codebase and
+ the current thread's context class loader as its arguments
+ <LI> associates the newly created
+ <code>ExportClassLoader</code> and the associated service's
+ policy file with the
+ <A HREF="../../../../com/sun/jini/start/AggregatePolicyProvider.html" title="class in com.sun.jini.start"><CODE>AggregatePolicyProvider</CODE></A>
+ <LI> sets the newly created <code>ExportClassLoader</code> as
+ the current thread's context class loader
+ <LI> loads the service object's class and calls a constructor
+ with the following signature:
+ <blockquote><pre><impl>(String[], LifeCycle)</blockquote></pre>
+ <LI> obtains the service proxy by calling
+ <A HREF="../../../../com/sun/jini/start/ServiceProxyAccessor.html#getServiceProxy()"><CODE>ServiceProxyAccessor.getServiceProxy()</CODE></A>
+ or
+ <A HREF="../../../../net/jini/export/ProxyAccessor.html#getProxy()"><CODE>ProxyAccessor.getProxy()</CODE></A>,
+ respectively, on the implementation instance.
+ If neither interface is supported, the
+ proxy reference is set to <code>null</code>
+ <LI> resets the context class loader to the
+ context classloader in effect when the method was called
+ </UL>
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/sun/jini/start/ServiceDescriptor.html#create(net.jini.config.Configuration)">create</A></CODE> in interface <CODE><A HREF="../../../../com/sun/jini/start/ServiceDescriptor.html" title="interface in com.sun.jini.start">ServiceDescriptor</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>config</CODE> - The <code>Configuration</code> object
+ used to configure the creation of the returned object.
+<DT><B>Returns:</B><DD>a
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.Created.html" title="class in com.sun.jini.start"><CODE>Created</CODE></A> instance with the service's proxy and implementation
+ references.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></CODE> - Thrown if there was any problem
+ creating the object.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="toString()"><!-- --></A><H3>
+toString</H3>
+<PRE>
+public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>toString</B>()</PRE>
+<DL>
+<DD>Prints out a field summary
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A></CODE> in class <CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></DL>
+</DD>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/NonActivatableServiceDescriptor.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../com/sun/jini/start/LoaderSplitPolicyProvider.html" title="class in com.sun.jini.start"><B>PREV CLASS</B></A>
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.Created.html" title="class in com.sun.jini.start"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?com/sun/jini/start/NonActivatableServiceDescriptor.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="NonActivatableServiceDescriptor.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: <A HREF="#nested_class_summary">NESTED</A> | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>
Added: websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/ServiceDescriptor.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/ServiceDescriptor.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/ServiceDescriptor.html Fri Dec 24 22:02:03 2010
@@ -0,0 +1,225 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:07 EST 2010 -->
+<TITLE>
+ServiceDescriptor (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="com.sun.jini.start.ServiceDescriptor interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="ServiceDescriptor (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ServiceDescriptor.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.Created.html" title="class in com.sun.jini.start"><B>PREV CLASS</B></A>
+ <A HREF="../../../../com/sun/jini/start/ServiceProxyAccessor.html" title="interface in com.sun.jini.start"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?com/sun/jini/start/ServiceDescriptor.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ServiceDescriptor.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+com.sun.jini.start</FONT>
+<BR>
+Interface ServiceDescriptor</H2>
+<DL>
+<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html" title="class in com.sun.jini.start">NonActivatableServiceDescriptor</A>, <A HREF="../../../../com/sun/jini/start/SharedActivatableServiceDescriptor.html" title="class in com.sun.jini.start">SharedActivatableServiceDescriptor</A>, <A HREF="../../../../com/sun/jini/start/SharedActivationGroupDescriptor.html" title="class in com.sun.jini.start">SharedActivationGroupDescriptor</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public interface <B>ServiceDescriptor</B></DL>
+</PRE>
+
+<P>
+Interface that all service description objects must implement.
+<P>
+
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../com/sun/jini/start/SharedActivationGroupDescriptor.html" title="class in com.sun.jini.start"><CODE>SharedActivationGroupDescriptor</CODE></A>,
+<A HREF="../../../../com/sun/jini/start/SharedActivatableServiceDescriptor.html" title="class in com.sun.jini.start"><CODE>SharedActivatableServiceDescriptor</CODE></A>,
+<A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html" title="class in com.sun.jini.start"><CODE>NonActivatableServiceDescriptor</CODE></A></DL>
+<HR>
+
+<P>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/ServiceDescriptor.html#create(net.jini.config.Configuration)">create</A></B>(<A HREF="../../../../net/jini/config/Configuration.html" title="interface in net.jini.config">Configuration</A> config)</CODE>
+
+<BR>
+ Creates an object described by the
+ actual <code>ServiceDescriptor</code> instance.</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="create(net.jini.config.Configuration)"><!-- --></A><H3>
+create</H3>
+<PRE>
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>create</B>(<A HREF="../../../../net/jini/config/Configuration.html" title="interface in net.jini.config">Configuration</A> config)
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></PRE>
+<DL>
+<DD>Creates an object described by the
+ actual <code>ServiceDescriptor</code> instance.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>config</CODE> - The <code>Configuration</code> object
+ used to configure the creation of the returned object.
+<DT><B>Returns:</B><DD>An object instance appropriate for the given
+ service descriptor instance.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></CODE> - Thrown if there was any problem
+ creating the object.</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ServiceDescriptor.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.Created.html" title="class in com.sun.jini.start"><B>PREV CLASS</B></A>
+ <A HREF="../../../../com/sun/jini/start/ServiceProxyAccessor.html" title="interface in com.sun.jini.start"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?com/sun/jini/start/ServiceDescriptor.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ServiceDescriptor.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>
Added: websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/ServiceProxyAccessor.html
==============================================================================
--- websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/ServiceProxyAccessor.html (added)
+++ websites/staging/river/trunk/content/river/doc/api/com/sun/jini/start/ServiceProxyAccessor.html Fri Dec 24 22:02:03 2010
@@ -0,0 +1,238 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_15) on Mon Mar 08 17:46:07 EST 2010 -->
+<TITLE>
+ServiceProxyAccessor (Apache River v2.1.2-SNAPSHOT API Documentation)
+</TITLE>
+
+<META NAME="keywords" CONTENT="com.sun.jini.start.ServiceProxyAccessor interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="ServiceProxyAccessor (Apache River v2.1.2-SNAPSHOT API Documentation)";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ServiceProxyAccessor.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../com/sun/jini/start/ServiceDescriptor.html" title="interface in com.sun.jini.start"><B>PREV CLASS</B></A>
+ <A HREF="../../../../com/sun/jini/start/ServiceStarter.html" title="class in com.sun.jini.start"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?com/sun/jini/start/ServiceProxyAccessor.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ServiceProxyAccessor.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+com.sun.jini.start</FONT>
+<BR>
+Interface ServiceProxyAccessor</H2>
+<HR>
+<DL>
+<DT><PRE>public interface <B>ServiceProxyAccessor</B></DL>
+</PRE>
+
+<P>
+Provides a means to obtain a client-side proxy from a
+ "base" service object.
+ <p>
+ This interface is typically implemented by a service implementation
+ and/or it's remote activatable reference, if any, to allow the service
+ to return the object of its choice for a client-side reference.
+ When a non-activatable service is created,
+ <A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html#create(net.jini.config.Configuration)"><CODE>NonActivatableServiceDescriptor.create()</CODE></A>,
+ returns the result from <code><impl>.getServiceProxy()</code>,
+ if supported, where <code><impl></code> is the service implementation
+ instance.
+ When an activatable service is created,
+ <A HREF="../../../../com/sun/jini/start/SharedActivatableServiceDescriptor.html#create(net.jini.config.Configuration)"><CODE>SharedActivatableServiceDescriptor.create()</CODE></A>,
+ returns the result of <code><act_ref>.getServiceProxy()</code>,
+ if supported, where <code><act_ref></code> is the service reference
+ returned by the call to
+ <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/activation/ActivationID.html#activate(boolean)" title="class or interface in java.rmi.activation"><CODE>ActivationID.activate()</CODE></A>.
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>2.0</DD>
+<DT><B>Author:</B></DT>
+ <DD>Sun Microsystems, Inc.</DD>
+<DT><B>See Also:</B><DD><A HREF="../../../../com/sun/jini/start/NonActivatableServiceDescriptor.html" title="class in com.sun.jini.start"><CODE>NonActivatableServiceDescriptor</CODE></A>,
+<A HREF="../../../../com/sun/jini/start/SharedActivatableServiceDescriptor.html" title="class in com.sun.jini.start"><CODE>SharedActivatableServiceDescriptor</CODE></A>,
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/activation/ActivationID.html" title="class or interface in java.rmi.activation"><CODE>ActivationID</CODE></A></DL>
+<HR>
+
+<P>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/sun/jini/start/ServiceProxyAccessor.html#getServiceProxy()">getServiceProxy</A></B>()</CODE>
+
+<BR>
+ Returns a proxy object for this object.</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="getServiceProxy()"><!-- --></A><H3>
+getServiceProxy</H3>
+<PRE>
+<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>getServiceProxy</B>()
+ throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></PRE>
+<DL>
+<DD>Returns a proxy object for this object. This value should not be
+ <code>null</code>.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>a proxy object reference
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/rmi/RemoteException.html" title="class or interface in java.rmi">RemoteException</A></CODE></DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ServiceProxyAccessor.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../com/sun/jini/start/ServiceDescriptor.html" title="interface in com.sun.jini.start"><B>PREV CLASS</B></A>
+ <A HREF="../../../../com/sun/jini/start/ServiceStarter.html" title="class in com.sun.jini.start"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html?com/sun/jini/start/ServiceProxyAccessor.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="ServiceProxyAccessor.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright 2007, multiple authors.<br>Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="child" >Apache License, Version 2.0</a>, see the <a href="../../../../doc-files/NOTICE" target="child" >NOTICE</a> file for attributions.
+</BODY>
+</HTML>