商业服务网格，第 7 部分: Keeping informed

String sessionid; // session id obtained from previous access validation
StockQuoteServiceDesk sd;	// previously created StockQuoteServiceDesk
String infoStr;	// service info string created for the service desk

// call to setServiceInfo
try {
	sd.setServiceInfo(sessionid, "byKey", null, infoStr, "self");
}
catch (Exception e) {
}

// setServiceInfo()
String sdKey; // key for the service desk obtained from a prior call to 
// servicedesk
ServiceDesk sd = new ServiceDesk(sdKey);	// re-starting a previously created 
// of getServiceInfo() call
String infoStr;; // service info string for the service desk... return value 
String[] info = sd.getServiceInfo(sessionid, "byKey", sdKey, "self");
// call to getServiceInfo
infoStr = info[0];

<gsdl:serviceData name = "serviceInfoList">
  <serviceInfoList>
    <serviceInfo servicekey = "" 
	  ServiceName = "DummyServiceBService"
      WsdlSvcIntfURL =
         "http://localhost/wstk/servicedomain/DummyServiceB_Interface.wsdl"
      WsdlImplURL=
         "http://localhost/wstk/servicedomain/DummyServiceB_Impl.wsdl"
      namespace = "http://DummyServiceB" 
      ServicePortName = "dummyservice" 
      ProviderName = "Provider Name" 
      ProviderDesc = "Provider Description"
	  ServiceDeskKey = ""/>
    <attributes>
	  <serviceType value="SOAP-RPC" />
	  <cloneable value="true" 
                CloneUUid = "clone instance id" 
	            ClassJarsProperty = "classJar" 
                DeployFileProperty = "deployfile" 
                ImplWSDLProperty = "ImplWSDL"/>
      <!-- other attribute tags -->
    </attributes>
    <measurements Availability="100.0" NumErrors="0" NumInvocations="4"
        NumOutstanding="0" NumTimedOut="0" Responsiveness="1191.0" />
    <sla value="PREMIER" />
  </serviceInfoList>
</gsdl:serviceData>

// session id
String sessionid;
// service instance GSH or WSDL implementation url
String uri;
// service data elements string per above
String serviceDataElementStr;
	................
service = new Service(new URL(wsdlImplURL), serviceQName)
call = (org.apache.axis.client.Call)service.createCall(portQName, "setServiceInfo");
call.invoke(new Object[]{sessionid, "byKey", uri, serviceDataElementStr, "self"});

// session id
String sessionid
// service domain GSH or WSDL implementation url; 
String SDuri;
// service instance GSH or WSDL implementation url
String uri;
// service data elements string per above
String serviceDataElementStr; 
	................
service = new Service(new URL(SDuri), serviceQName)
call = (org.apache.axis.client.Call)service.createCall(portQName, "Register");
call.invoke(new Object[] { sessionid, uri, reg_namespace, 
    reg_serviceName, reg_portName, reg_portType, slData });

<services>
	XML xPath results
</services>

//serviceInfoList/*[@servicekey=
"1326031c-27e6-4a1e-870e-193409c4091f"]/ancester::service
get a list of service instances with servicekey=
1326031c-27e6-4a1e-870e-193409c4091f

//serviceInfoList/*[@serviceDeskKey=
"111c2a7e-37ae-4391-a1ac-129d200029b4"]/ancester::service
get a list of provided service instance with serviceDeskKey=
111c2a7e-37ae-4391-a1ac-129d200029b4

//serviceInfoList/*[@servicename="
DummyServiceBService"]/ancester::service
get a list of service instances with servicename=
DummyServiceBService

// session id
String sessionid; 
// XML xPath query string as constructed above
String xPathStr;
// service domain GSH or WSDL implementation url
String SDuri;
................
service = new Service(new URL(SDuri), serviceQName)
call = (org.apache.axis.client.Call)service.createCall(portQName, "getServiceInfo");
String[] result = call.invoke(new Object[]{sessionid, "byXPath", xPathStr, "self"});

<services>
  <service>
	...service information for the domain here...
	  </service>
  <service> 
     <description referencedNamespace = "http://schemas.xmlsoap.org/wsdl/" 
	Location = "http://localhost/wstk/servicedomain/DummyServiceB_Impl.wsdl">
     </description>
     <gsdl:serviceData name = "serviceInfoList">
       <serviceInfoList>
         <serviceInfo servicekey = "1326031c-27e6-4a1e-870e-193409c4091f" 
	         ServiceName = "DummyServiceBService"
             WsdlSvcIntfURL =
                "http://localhost/wstk/servicedomain/DummyServiceB_Interface.wsdl"
             WsdlImplURL=
                "http://localhost/wstk/servicedomain/DummyServiceB_Impl.wsdl"	
             namespace = "http://DummyServiceB" 
             ServicePortName = "dummyservice" 
             ProviderName = "Provider Name" 
             ProviderDesc = "Provider Description"
		  ServiceDeskKey = "111c2a7e-37ae-4391-a1ac-129d200029b4"/>
         <attributes>
	        <serviceType value="SOAP-RPC" />
 	     <cloneable CloneUUid = "clone instance id" 
		  ClassJarsProperty = "classJar" 
             DeployFileProperty = "deployfile" 
             ImplWSDLProperty = "ImplWSDL" />
         </attributes>
         <measurements Availability="100.0" NumErrors="0" NumInvocations="4" 
             NumOutstanding="0" NumTimedOut="0" Responsiveness="1191.0" />
         <sla value="PREMIER" /> 	
      </serviceInfoList> 
    </gsdl:serviceData> 
  </service>
  <service>
...another service instance information here...
  </service>
</services>

/*  Getting a snapshot of service domain measurements
 *  
 *  This example shows how to collect service domain metrics
 *   including all its supplier instances. 
 *  The information can be used by an application that displays
 *   runtime statistics on an administrative console, where "sh" 
 *   is a ServiceHub object and sessionid is the handle of the
 *  current session returned from a previous logon.
*/  

String[ ] results1 = sh.getServiceInfo
(sessionid,  "byType", "measurements", "self and immediate");  

/*  Getting a snapshot of the attributes of all supplier service instances
 *  
 *  This example shows how to get an update of the current 
 *  list of supplier instances and their service attributes. The 
 *  information can be used by an application that displays service 
 *  instance configurations on an administrative console, where 
 * "sh" is a ServiceHub object and sessionid is the handle of the 
 *  current session returned from a previous logon
 */  
 	
String[ ] results2 = sh.getServiceInfo
(sessionid,  "byType", "serviceInfo and attributes", "immediate"); 

/*  Getting a snapshot of basic service descriptions of entire service domain 
 *  
 *  This example shows how to get a complete list of supplier
 *   instances and their basic service descriptions. The information can 
 *  be used by an application at initialization time to prepare an object
 *  structure to keep track of subsequent changes, where "sh" is a ServiceHub 
 *  object and sessionid is the handle of the current session 
 *  returned from a previous logon
 */ 
String[ ] results3 = sh.getServiceInfo(sessionid,  "byType", "serviceInfo", "all"); 

/*  Setting new information in service domain 
 *  
 *  This example shows how to update the list of supplier instances
 *  and their basic service descriptions. The information can be 
 *  used by an application at run time to update service domain 
 *  when changes such as registering new instances are made, 
 *  where "sh" is a ServiceHub object and sessionid is the handle 
 *   of the current session returned from a previous 
 *  logon
 */  	
		
String[ ] results4 = sh.setServiceInfo
 (sessionid,  "byType", "serviceInfo", input service string, "immediate");

/*  Create a main control data structure object as the 
*   single access point of information.
 *  The object provides methods to navigate to specific 
 *  pieces of information encapsulated in objects of smaller 
 *  granularity. They correspond typically to the tag names
 *   of the xml information string. Below the "results" object
 *   is the full service information string returned    
 *  from a getServiceInfo() call. The object class names 
 *  are mostly based on the xml tag names.
 */ 

ControlDataStructure cds = new ControlDataStructure(results);

services mySelf = cds.getSelf();
// mySelf represents the information of  the service domain
// object, ServiceDesk or ServiceHub, that getSer
// has requested

services  = cds.getImmediate();
// myImmediate represents the information of  
// the service domain objects, ServiceDesk or
// ServiceHub, or service instances that are 
// registered to mySelf

service[] supplierList = mySelf.getServices();
// get an array of supplier information in mySelf
// first entry is mySelf, the rest all suppliers 
// registered with mySelf 

service x = mySelf.getService("name of x");
// get a specific supplier information by name (or key)

measurements m = x.getMeasurements();
// get the measurements information for supplier x

/*  Create a point control data structure object for fast path
*  access to a specific piece of information
 *  
 *  The object takes the "results" object of the full service
 *   information string returned from a getServiceInfo() and 
 *   extracts out just the specific piece of information, where
 *  "rootDataStructure" is a base class used to provide the 
 *   factory methods.
 */ 
	
// get measurements for all suppliers covered by the getServiceInfo()
measurements[] supplierMetrics = rootDataStructure.getMeasurements(results);

// get serviceInfo for all suppliers covered by the getServiceInfo() 
serviceInfo[] supplierServiceInfos = rootDataStructure.getServiceInfo(results);

// get attributes for all suppliers covered by the getServiceInfo() 
attributes[] supplierAttributes = rootDataStructure.getAttributes(results);

/*initialize control data structure object from service domain's 
service information*/
        
// assume ControlDataStructure and services as previously defined
ControlDataStructure cds = new ControlDataStructure(results);
services mySelf = cds.getSelf();  

Vector supplierNames = mySelf.getNames();
// get the list of supplier names 

/* add a new supplier */

// assume sh as previously defined, register the new supplier
String servicekey = sh.Register
     (sessionid,  uri-wsdlImpl, reg_namespace, reg_servicename, 
     reg_portName, reg_portType, slData);
supplierNames.addElement("new supplier name"); 

/* update service domain's service information

// assume the services object has provided a method to 
// add a new service with a registered key and additional 
// descriptive information. The object will use the key 
// to make a setServiceInfo call with the new descriptive
// information myself.addService(servicekey, information_string);