Java Doc for RegistrationData.java in  » IDE-Netbeans » reglib » com » sun » servicetag » Java Source Code / Java DocumentationJava Source Code and Java Documentation

hostname	Hostname of the system	e.g. woody
hostId	Host ID of the system	e.g. 83abc1ab
osName	Operating system name	e.g. SunOS
osVersion	Operating system version	e.g. 5.10
osArchitecture	Operating system architecture	e.g. sparc
systemModel	System model	e.g. SUNW,Sun-Fire-V440
systemManufacturer	System manufacturer	e.g. Sun Microsystems
cpuManufacturer	CPU manufacturer	e.g. Sun Microsystems
serialNumber	System serial number	e.g. BEL078932

Registration XML Schema

A RegistrationData object can be RegistrationData.loadFromXML loaded from and RegistrationData.storeToXML stored into an XML file in the format described by the registration data schema. The registration data schema is defined by the Service Tags Technology.

Typically the registration data is constructed at installation time and stored in an XML file for later service tag lookup or registration.

Example Usage

The examples below show how the RegistrationData can be used for product registration. Exception handling is not shown in these examples for clarity.

1. This example shows how the JDK creates a JDK service tag, installs it in the system service tag registry and adds it to the registration data.
   

    // create a service tag object with an instance_urn
    ServiceTag st = ServiceTag.newInstance(ServiceTag.generateInstanceURN(),
    ....);
    // Adds to the system service tag registry if supported
    if (Registry.isSupported()) {
    Registry.getSystemRegistry().addServiceTag(st);
    }
    // add to the registration data
    RegistrationData registration  = new RegistrationData();
    registration.addServiceTag(st); 
    

2. At this point, the registration data is ready to send to Sun Connection for registration. This example shows how to register the JDK via the Registration Relay Service.

   There are several registration services for Sun Connection. For example, the Registration Relay Service is a web application interface that processes the registration data payload sent via HTTP post and hosts the registration user interface for a specified registration URL. Refer to the Registration Relay Service Specification for details.

    // Open the connection to the URL of the registration service
    HttpsURLConnection con = (HttpsURLConnection) url.openConnection();
    con.setDoInput(true);
    con.setDoOutput(true);
    con.setUseCaches(false);
    con.setAllowUserInteraction(false);
    con.setRequestMethod("POST");
    con.setRequestProperty("Content-Type", "text/xml;charset=\"utf-8\"");
    con.connect();
    // send the registration data to the registration service
    OutputStream out = con.getOutputStream();
    registration.storeToXML(out);
    out.close();
    

3. This example shows how to store the registration data in an XML file. for later service tag lookup or registration.
   

    BufferedOutputStream out = new BufferedOutputStream(
    new FileOutputStream(""<JAVA_HOME>/lib/servicetag/registration.xml"));
    registration.storeToXML(out);
    out.close();
    

4. This example shows how to install service tags that are in the registration data in the system service tag registry when determined to be available. The system service tag registry might not have existed when the registration data was constructed.
   

    if (Registry.isSupported()) {
    Set<ServiceTag> svctags = registration.getServiceTags();
    for (ServiceTag st : svctags) {
    Registry.getSystemRegistry().addServiceTag(st);
    }
    }
    

hostname, osName, osVersion and osArchitecture