Primeri uporabe spletnih servisov so narejeni za Java 2 Platform, Standard Edition (J2SE) v1.4.2 ter Java Web Services Developers Pack (JWSDP) v1.4.
Primeri so na voljo v obliki ZIP arhiva s projektom za razvojno okolje Eclipse WebServiceSamples_java.zip.
Datoteka com.halcom.ws.jar (\WebServiceSamples_java.zip\WebServiceSamples_java\lib) vsebuje že prevedene t.i. posredniške (“proxy/stub”) razrede za dostop do spletnih servisov. Posredniške razrede je mogoče ponovno izdelati z uporabo orodja wscompile iz paketa JWSDP.
OPOZORILO:
Ker ima wscompile težave pri preverjanju digitalnega potrdila strežnika, kjer se nahajajo WSDL datoteke spletnih servisov, je posredniške razrede lažje zgraditi s pomočjo lokalne kopije datotek WSDL. Nastavitvene datoteke za orodje wscompile se nahajajo v imeniku wsdl/ v arhivu WebServiceSamples_java.zip.
Za uporabo primerov je poleg datoteke com.halcom.ws.jar potrebno v proces gradnje vključiti še naslednje datoteke JAR iz paketa JWSDP:
- jaxrpc/lib/jaxrpc-api.jar
- jaxrpc/lib/jaxrpc-impl.jar
- jaxrpc/lib/jaxrpc-spi.jar
- jwsdp-shared/lib/relaxngDatatype.jar
- jwsdp-shared/lib/jax-qname.jar
- jwsdp-shared/lib/xsdlib.jar
- jaxp/lib/jaxp-api.jar
- jaxp/lib/endorsed/xercesImpl.jar
- jaxp/lib/endorsed/sax.jar
- jaxp/lib/endorsed/xalan.jar
- jaxp/lib/endorsed/dom.jar
- jwsdp-shared/lib/mail.jar
- jwsdp-shared/lib/activation.jar
- saaj/lib/saaj-impl.jar
- saaj/lib/saaj-api.jar
Primeri pričakujejo, da se med uporabo na trenutnem imeniku nahaja nekaj datotek:
- wsclient.p12 – PKCS#12 (Personal Information Exchange) datoteka z osebnim ključem in digitalnim potrdilom, ki se uporablja za dostop do servisov; geslo za dostop do datoteke je “1234”,
- cert.cer – datoteka z digitalnim potrdilom, ki se pošlje v obdelavo spletnim servisom,
- cacerts.jks – Java zbirka ključev (“keystore”) z digitalnimi potrdili zaupanja vrednih (“trusted”) CA agencij. V zbirki se mora nahajati digitalno potrdilo agencije Halcom CA PO 2, v okrilju katere je izdano strežniško potrdilo strežnika spletnih servisov (ws.halcom.si). Geslo za dostop do zbirke je “123456”. Arhiv s primeri WebServiceSamples_java.zip že vsebuje ustrezno pripravljeno datoteko cacerts.jks z digitalnim potrdilom agencije Halcom CA PO 2.