Return-Path: X-Original-To: apmail-river-commits-archive@www.apache.org Delivered-To: apmail-river-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 209779BAD for ; Sat, 21 Jan 2012 07:29:22 +0000 (UTC) Received: (qmail 34252 invoked by uid 500); 21 Jan 2012 07:29:21 -0000 Delivered-To: apmail-river-commits-archive@river.apache.org Received: (qmail 34164 invoked by uid 500); 21 Jan 2012 07:29:19 -0000 Mailing-List: contact commits-help@river.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@river.apache.org Delivered-To: mailing list commits@river.apache.org Received: (qmail 34134 invoked by uid 99); 21 Jan 2012 07:29:14 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 21 Jan 2012 07:29:14 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 21 Jan 2012 07:29:11 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 143B52388A9B; Sat, 21 Jan 2012 07:28:51 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1234278 [4/29] - in /river/tck: ./ configs/ doc/ doc/api/ doc/api/com/ doc/api/com/sun/ doc/api/com/sun/jini/ doc/api/com/sun/jini/compat/ doc/api/com/sun/jini/compat/admin1/ doc/api/com/sun/jini/compat/admin2/ doc/api/com/sun/jini/compat/... Date: Sat, 21 Jan 2012 07:28:36 -0000 To: commits@river.apache.org From: peter_firmstone@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20120121072851.143B52388A9B@eris.apache.org> Propchange: river/tck/doc/api/com/sun/jini/compat/admin1/TransientServiceAdmin.html ------------------------------------------------------------------------------ svn:eol-style = native Added: river/tck/doc/api/com/sun/jini/compat/admin1/package-frame.html URL: http://svn.apache.org/viewvc/river/tck/doc/api/com/sun/jini/compat/admin1/package-frame.html?rev=1234278&view=auto ============================================================================== --- river/tck/doc/api/com/sun/jini/compat/admin1/package-frame.html (added) +++ river/tck/doc/api/com/sun/jini/compat/admin1/package-frame.html Sat Jan 21 07:28:27 2012 @@ -0,0 +1,46 @@ + + + + + + +com.sun.jini.compat.admin1 (Jini(TM) Technology LDJ Kit 1.0 API Documentation) + + + + + + + + + + + +com.sun.jini.compat.admin1 + + + + +
+Classes  + +
+FiddlerAdmin +
+MahaloAdmin +
+MercuryAdmin +
+NormAdmin +
+OutriggerAdmin +
+ReggieAdmin +
+ReggieServiceAdmin +
+TransientServiceAdmin
+ + + + Propchange: river/tck/doc/api/com/sun/jini/compat/admin1/package-frame.html ------------------------------------------------------------------------------ svn:eol-style = native Added: river/tck/doc/api/com/sun/jini/compat/admin1/package-summary.html URL: http://svn.apache.org/viewvc/river/tck/doc/api/com/sun/jini/compat/admin1/package-summary.html?rev=1234278&view=auto ============================================================================== --- river/tck/doc/api/com/sun/jini/compat/admin1/package-summary.html (added) +++ river/tck/doc/api/com/sun/jini/compat/admin1/package-summary.html Sat Jan 21 07:28:27 2012 @@ -0,0 +1,211 @@ + + + + + + +com.sun.jini.compat.admin1 (Jini(TM) Technology LDJ Kit 1.0 API Documentation) + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + +
Overview   Package  Class  Tree  Deprecated  Index  Help 
+		 + +
+ PREV PACKAGE  + NEXT PACKAGE + FRAMES   + NO FRAMES   +  + + +
+ + + +
+

+Package com.sun.jini.compat.admin1 +

+This package contains admin implementations for the services that ship +with the Jini(TM) Technology Starter Kit, v1.2.1. +

+See: +
+          Description +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Class Summary
FiddlerAdminThis class implements the BasicServiceAdmin interface to automate + the testing of the Fiddler service from the Jini(TM) Technology Helper Services.
MahaloAdminThis class implements the BasicServiceAdmin interface to automate + the testing of the Mahalo Transaction Manager service from the + Jini(TM) Technology Software Kit (JSK).
MercuryAdminThis class implements the BasicServiceAdmin interface to automate + the testing of the Mercury service from the Jini(TM) Technology Helper Services.
NormAdminThis class implements the BasicServiceAdmin interface to automate + the testing of the Norm service from the Jini(TM) Technology Helper Services.
OutriggerAdminThis class implements the BasicServiceAdmin interface to automate + the testing of the Outrigger service from the + Jini(TM) Technology Software Kit (JSK).
ReggieAdminThis class implements the BasicLookupAdmin interface + and the BasicServiceAdmin interface to + automate the testing of the Reggie lookup service implementation, which + is part of the Jini(TM) Technology Software Kit (JSK).
ReggieServiceAdminThis class implements the BasicServiceAdmin interface to + automate the testing of the Reggie lookup service implementation, which + is part of the Jini(TM) Technology Software Kit (JSK).
TransientServiceAdminThis class implements the BasicServiceAdmin interface + to automate the testing of a transient service.
+  + +

+

+Package com.sun.jini.compat.admin1 Description +

+ +

+This package contains admin implementations for the services that ship +with the Jini(TM) Technology Starter Kit, v1.2.1. + +These classes are provided as examples of how to +write your own service's admin. Admins are used to automate the testing of a +program using the Jini Technology Lookup, Discovery, and Join Compatibility Kit. +

+ +

+

+
See Also:
Implementing the LDJ Kit Admin Interface, +Running the Jini Technology Lookup, Discovery, and Join Compatibility Kit
+
+ + + + + + + + + + + + + + + +
+ + + + + + + + + + + +
Overview   Package  Class  Tree  Deprecated  Index  Help 
+		 + +
+ PREV PACKAGE  + NEXT PACKAGE + FRAMES   + NO FRAMES   +  + + +
+ + + +
+Copyright 2005, Sun Microsystems, Inc.
Licensed under the Apache License, Version 2.0. + + Propchange: river/tck/doc/api/com/sun/jini/compat/admin1/package-summary.html ------------------------------------------------------------------------------ svn:eol-style = native Added: river/tck/doc/api/com/sun/jini/compat/admin1/package-tree.html URL: http://svn.apache.org/viewvc/river/tck/doc/api/com/sun/jini/compat/admin1/package-tree.html?rev=1234278&view=auto ============================================================================== --- river/tck/doc/api/com/sun/jini/compat/admin1/package-tree.html (added) +++ river/tck/doc/api/com/sun/jini/compat/admin1/package-tree.html Sat Jan 21 07:28:27 2012 @@ -0,0 +1,151 @@ + + + + + + +com.sun.jini.compat.admin1 Class Hierarchy (Jini(TM) Technology LDJ Kit 1.0 API Documentation) + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + +
Overview  Package  Class   Tree  Deprecated  Index  Help 
+		 + +
+ PREV  + NEXT + FRAMES   + NO FRAMES   +  + + +
+ + + +
+
+

+Hierarchy For Package com.sun.jini.compat.admin1 +

+
+
+
Package Hierarchies:
All Packages
+
+

+Class Hierarchy +

+ +
+ + + + + + + + + + + + + + + +
+ + + + + + + + + + + +
Overview  Package  Class   Tree  Deprecated  Index  Help 
+		 + +
+ PREV  + NEXT + FRAMES   + NO FRAMES   +  + + +
+ + + +
+Copyright 2005, Sun Microsystems, Inc.
Licensed under the Apache License, Version 2.0. + + Propchange: river/tck/doc/api/com/sun/jini/compat/admin1/package-tree.html ------------------------------------------------------------------------------ svn:eol-style = native Added: river/tck/doc/api/com/sun/jini/compat/admin2/ExecServiceAdmin.html URL: http://svn.apache.org/viewvc/river/tck/doc/api/com/sun/jini/compat/admin2/ExecServiceAdmin.html?rev=1234278&view=auto ============================================================================== --- river/tck/doc/api/com/sun/jini/compat/admin2/ExecServiceAdmin.html (added) +++ river/tck/doc/api/com/sun/jini/compat/admin2/ExecServiceAdmin.html Sat Jan 21 07:28:27 2012 @@ -0,0 +1,484 @@ + + + + + + +ExecServiceAdmin (Jini(TM) Technology LDJ Kit 1.0 API Documentation) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + +
Overview  Package   Class  Tree  Deprecated  Index  Help 
+		 + +
+ PREV CLASS  + NEXT CLASS + FRAMES   + NO FRAMES   +  + + +
+ SUMMARY: NESTED | FIELD | CONSTR | METHOD +DETAIL: FIELD | CONSTR | METHOD
+ + + +
+ +

+ +com.sun.jini.compat.admin2 +
+Class ExecServiceAdmin

+
+java.lang.Object
+  extended bycom.sun.jini.compat.admin2.ExecServiceAdmin
+
+
+
All Implemented Interfaces:
BasicAdmin, BasicLookupAdmin, BasicServiceAdmin
+
+
+
+
public class ExecServiceAdmin
extends java.lang.Object
implements BasicServiceAdmin, BasicLookupAdmin
+ +

+This class implements the BasicServiceAdmin and BasicLookupAdmin + interfaces to automate the testing of any transient or persistent + programs. Some methods document properties that they support. +

+ +

+

+ +

+ + + + + + + + + + +
+Field Summary
+  + + + + + + + +
Fields inherited from interface com.sun.jini.compat.harness.BasicServiceAdmin
CATEGORY
+  + + + + + + + +
Fields inherited from interface com.sun.jini.compat.harness.BasicLookupAdmin
CATEGORY
+  + + + + + + + + + + +
+Constructor Summary
ExecServiceAdmin() + +
+          Basic no-arg constructor.
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ java.net.InetAddressgetAddress() + +
+          Returns the address of this host.
+ ServiceRegistrargetServiceRegistrar() + +
+          Returns the ServiceRegistrar from an already started Lookup.
+ ServiceTemplategetTemplate() + +
+          Return a blank ServiceTemplate.
+ ServiceItempickService(ServiceItem[] services) + +
+          Given an array of service proxy objects, this method + returns the first one that contains a proxy that + implements the interface specified by the property + com.sun.jini.compat.admin2.execServiceAdmin.interface.
+ voidsetConfig(Config conf) + +
+          See comments for BasicAdmin.
+ voidstart() + +
+          Using the Runtime.exe() method, starts the program(s) + by running the command given by the property + com.sun.jini.compat.admin2.execServiceAdmin.startCommand.
+ voidstop() + +
+          Stops the program.
+  + + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + + + + +
+Constructor Detail
+ +

+ExecServiceAdmin

+
+public ExecServiceAdmin()
+
+
Basic no-arg constructor. +

+

+ + + + + + + + +
+Method Detail
+ +

+setConfig

+
+public void setConfig(Config conf)
+
+
See comments for BasicAdmin. +

+

+
Specified by:
setConfig in interface BasicAdmin
+
+
+
Parameters:
conf - the configuration object
+
+
+
+ +

+getAddress

+
+public java.net.InetAddress getAddress()
+                                throws java.rmi.RemoteException
+
+
Returns the address of this host. The program must + be running on this host. +

+

+
Specified by:
getAddress in interface BasicAdmin
+
+
+ +
Returns:
the address of the program +
Throws: +
java.rmi.RemoteException
+
+
+
+ +

+start

+
+public void start()
+           throws java.rmi.RemoteException
+
+
Using the Runtime.exe() method, starts the program(s) + by running the command given by the property + com.sun.jini.compat.admin2.execServiceAdmin.startCommand. +

+

+
Specified by:
start in interface BasicAdmin
+
+
+ +
Throws: +
java.rmi.RemoteException - if problem starting the program
+
+
+
+ +

+stop

+
+public void stop()
+          throws java.rmi.RemoteException
+
+
Stops the program. This method does not need to wait + for the program to stop. In addition, this method may + be called safely even if the start() method threw an exception + or was never called. +

+

+
Specified by:
stop in interface BasicAdmin
+
+
+ +
Throws: +
java.rmi.RemoteException - problem stopping the program
+
+
+
+ +

+pickService

+
+public ServiceItem pickService(ServiceItem[] services)
+                        throws java.rmi.RemoteException
+
+
Given an array of service proxy objects, this method + returns the first one that contains a proxy that + implements the interface specified by the property + com.sun.jini.compat.admin2.execServiceAdmin.interface. + If the specified interface is not implemented by any of + the listed services, then null is returned. +

+

+
Specified by:
pickService in interface BasicServiceAdmin
+
+
+
Parameters:
services - the array ServiceItem objects + from which to choose +
Returns:
the ServiceItem for the service being tested, + or null +
Throws: +
java.rmi.RemoteException
+
+
+
+ +

+getTemplate

+
+public ServiceTemplate getTemplate()
+                            throws java.rmi.RemoteException
+
+
Return a blank ServiceTemplate. +

+

+
Specified by:
getTemplate in interface BasicServiceAdmin
+
+
+ +
Returns:
the template +
Throws: +
java.rmi.RemoteException
+
+
+
+ +

+getServiceRegistrar

+
+public ServiceRegistrar getServiceRegistrar()
+                                     throws java.rmi.RemoteException
+
+
Returns the ServiceRegistrar from an already started Lookup. + If there are any problems getting the ServiceRegistrar it + throws a RemoteException. It uses a property called: + com.sun.jini.compat.admin2.execServiceAdmin.lookupPort. + Using that port and the address of the lookup provided by + the getAddress method it generates a + LookupLocator to get the + ServiceRegistrar for the lookup service being + tested. +

+

+
Specified by:
getServiceRegistrar in interface BasicLookupAdmin
+
+
+ +
Returns:
the ServiceRegistrar for the lookup being + tested. +
Throws: +
java.rmi.RemoteException
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + +
Overview  Package   Class  Tree  Deprecated  Index  Help 
+		 + +
+ PREV CLASS  + NEXT CLASS + FRAMES   + NO FRAMES   +  + + +
+ SUMMARY: NESTED | FIELD | CONSTR | METHOD +DETAIL: FIELD | CONSTR | METHOD
+ + + +
+Copyright 2005, Sun Microsystems, Inc.
Licensed under the Apache License, Version 2.0. + + Propchange: river/tck/doc/api/com/sun/jini/compat/admin2/ExecServiceAdmin.html ------------------------------------------------------------------------------ svn:eol-style = native Added: river/tck/doc/api/com/sun/jini/compat/admin2/ServiceDestroyer.html URL: http://svn.apache.org/viewvc/river/tck/doc/api/com/sun/jini/compat/admin2/ServiceDestroyer.html?rev=1234278&view=auto ============================================================================== --- river/tck/doc/api/com/sun/jini/compat/admin2/ServiceDestroyer.html (added) +++ river/tck/doc/api/com/sun/jini/compat/admin2/ServiceDestroyer.html Sat Jan 21 07:28:27 2012 @@ -0,0 +1,445 @@ + + + + + + +ServiceDestroyer (Jini(TM) Technology LDJ Kit 1.0 API Documentation) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + +
Overview  Package   Class  Tree  Deprecated  Index  Help 
+		 + +
+ PREV CLASS  + NEXT CLASS + FRAMES   + NO FRAMES   +  + + +
+ SUMMARY: NESTED | FIELD | CONSTR | METHOD +DETAIL: FIELD | CONSTR | METHOD
+ + + +
+ +

+ +com.sun.jini.compat.admin2 +
+Class ServiceDestroyer

+
+java.lang.Object
+  extended bycom.sun.jini.compat.admin2.ServiceDestroyer
+
+
+
+
public class ServiceDestroyer
extends java.lang.Object
+ +

+This class provides static methods that can be used to destroy a service. +

+ +

+

+ +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Field Summary
+static intDEACTIVATION_TIMEOUT + +
+           
+static intDESTROY_SUCCESS + +
+           
+static intPERSISTENT_STORE_EXISTS + +
+           
+static intSERVICE_NOT_ADMINISTRABLE + +
+           
+static intSERVICE_NOT_DESTROY_ADMIN + +
+           
+  + + + + + + + + + + +
+Constructor Summary
ServiceDestroyer() + +
+           
+  + + + + + + + + + + + + + + + +
+Method Summary
+static intdestroy(java.lang.Object service) + +
+          Administratively destroys the service referenced by the input + parameter.
+static intdestroy(SharedActivatableServiceDescriptor.Created created, + int nSecsWait) + +
+          Administratively destroys the service referenced by the + proxy parameter, which is assumed to be running + under a shared VM environment.
+  + + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Field Detail
+ +

+DESTROY_SUCCESS

+
+public static final int DESTROY_SUCCESS
+
+
+
See Also:
Constant Field Values
+
+
+ +

+SERVICE_NOT_ADMINISTRABLE

+
+public static final int SERVICE_NOT_ADMINISTRABLE
+
+
+
See Also:
Constant Field Values
+
+
+ +

+SERVICE_NOT_DESTROY_ADMIN

+
+public static final int SERVICE_NOT_DESTROY_ADMIN
+
+
+
See Also:
Constant Field Values
+
+
+ +

+DEACTIVATION_TIMEOUT

+
+public static final int DEACTIVATION_TIMEOUT
+
+
+
See Also:
Constant Field Values
+
+
+ +

+PERSISTENT_STORE_EXISTS

+
+public static final int PERSISTENT_STORE_EXISTS
+
+
+
See Also:
Constant Field Values
+
+ + + + + + + + +
+Constructor Detail
+ +

+ServiceDestroyer

+
+public ServiceDestroyer()
+
+
+ + + + + + + + +
+Method Detail
+ +

+destroy

+
+public static int destroy(java.lang.Object service)
+                   throws java.rmi.RemoteException
+
+
Administratively destroys the service referenced by the input + parameter. The service input to this method must implement + both net.jini.admin.Administrable and the + com.sun.jini.admin.DestroyAdmin interfaces + in order for this method to successfully destroy the service. +

+

+
Parameters:
service - reference to the service to destroy +
Returns:
int value that indicates either success or + one of a number of possible reasons for failure to destroy + the service. Possible values are: +

    +
  • ServiceDestroyer.DESTROY_SUCCESS +
  • ServiceDestroyer.SERVICE_NOT_ADMINISTRABLE - returned when + the service to destroy is not an instance of + net.jini.admin.Administrable +
  • ServiceDestroyer.SERVICE_NOT_DESTROY_ADMIN - returned when + the service to destroy is not an instance of + com.sun.jini.admin.DestroyAdmin +
+
Throws: +
java.rmi.RemoteException - typically, this exception occurs when + there is a communication failure between the client and the + service's backend. When this exception does occur, the + service may or may not have been successfully destroyed.
+
+
+
+ +

+destroy

+
+public static int destroy(SharedActivatableServiceDescriptor.Created created,
+                          int nSecsWait)
+                   throws java.rmi.RemoteException,
+                          java.rmi.activation.ActivationException
+
+
Administratively destroys the service referenced by the + proxy parameter, which is assumed to be running + under a shared VM environment. This method attempts to verify + that the desired service is indeed destroyed by verifying that + the service's activation information/descriptor is no longer + registered with the activation system. +

+

+
Parameters:
created - the id of the activation group in which the service to + destroy is registered, the activation ID of the + service to destroy, and the reference to the service + to destroy
nSecsWait - the number of seconds to wait for the service's + activation descriptor to be no longer registered with + the activation system +
Returns:
int value that indicates either success or + one of a number of possible reasons for failure to destroy + the service. Possible values are: +

    +
  • ServiceDestroyer.DESTROY_SUCCESS +
  • ServiceDestroyer.SERVICE_NOT_ADMINISTRABLE - returned when + the service to destroy is not an instance of + net.jini.admin.Administrable +
  • ServiceDestroyer.SERVICE_NOT_DESTROY_ADMIN - returned when + the service to destroy is not an instance of + com.sun.jini.admin.DestroyAdmin +
  • ServiceDestroyer.DEACTIVATION_TIMEOUT - returned when the + service's activation descriptor is still registered with the + activation system after the number of seconds to wait have passed +
  • ServiceDestroyer.PERSISTENT_STORE_EXISTS - returned when the + directory in which the service stores its persistent state + still exists after the service has been successfully destroyed +
+
Throws: +
java.rmi.RemoteException - typically, this exception occurs when + there is a communication failure between the client and the + service's backend. When this exception does occur, the + service may or may not have been successfully destroyed. +
java.rmi.activation.ActivationException - typically, this + exception occurs when problems arise while attempting to + interact with the activation system
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + +
Overview  Package   Class  Tree  Deprecated  Index  Help 
+		 + +
+ PREV CLASS  + NEXT CLASS + FRAMES   + NO FRAMES   +  + + +
+ SUMMARY: NESTED | FIELD | CONSTR | METHOD +DETAIL: FIELD | CONSTR | METHOD
+ + + +
+Copyright 2005, Sun Microsystems, Inc.
Licensed under the Apache License, Version 2.0. + + Propchange: river/tck/doc/api/com/sun/jini/compat/admin2/ServiceDestroyer.html ------------------------------------------------------------------------------ svn:eol-style = native