Versions Compared

Old Version 2

changes.mady.by.user Unknown User (jpe@kvalitetsit.dk)

Saved on

compared with

New Version 3

changes.mady.by.user Unknown User (jpe@kvalitetsit.dk)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Wildfly modul navn: dk.sds.nsp.minlog.api

...

Minlog-producer-registration

Dette bibliotek indeholder implementering af interface defineret i minlog-producer-api biblioteket.

...

Wildfly modul navn: dk.sds.nsp.minlog.producer


Dette bibliotek har en afhængighed til minlog-producer-api biblioteket, så det er kun nødvendigt at anvende dette bibliotek i sit projekt.


API Beskrivelse og anvendelse

Anvendelse af API sker primært gennem to klasser og så en række POJO klasser.

RegisterServiceProvider

Dette er service provider klassen. Den definerer en enkelt statisk metode og denne metode skal kaldes for at få en instans af RegisterService. Metoden man skal kalde hedder getRegisterService().

Hvis man kalder getRegisterService() metoden UDEN at have minlog-producer-registration på sin classpath så får man en test implementering af RegisterService. Denne udgave sender IKKE data til MinLog og validerer heller ikke input. Den logger udelukkende kald til via log4j.

RegisterService

Når man har anvendt RegisterServiceProvider til at få en implementering af RegisterService er der 4 metoder man kan kalde.

void init(Properties properties)

Denne metode skal kaldes inden man kalder andre metoder. Hvis man ikke går dette får man en exception. De properties der skal angives som argument er dem der kan anvendes til at konfigurere en KafkaProducer.

RegistrationResult addRegistrations(List<LogEntry>)

Denne metode kaldes for at registrere i MinLog. Argumentet indeholder en liste af LogEntry objekter som repræsenterer de data der skal registreres i MinLog. RegistrationResult er resultatet af registreringen.

void flush()

Sørger for at kalde flush() på KafkaProducer. Metoden skal kaldes hvor gang man vi sikre sig at kald til addRegistrations() er persisteret i Kafka.

void close()

Kaldes når servicen ikke længere skal bruges. Sørger for pænt at lukke forbindelsen til Kafka osv.

LogEntry


Source

Destination


I forbindelse med version 3 af Seal.java er det besluttet at opdele koden, så den bliver fordelt i flere moduler. Det gøres bl.a. for at undgå at serviceudbydere behøver at hente al Seal.java koden ned, hvis man kun har behøv for at udstille en DGWS service.

Serviceudbydere kan desuden hente DGWS og IDWS modulerne uden at de samtidigt får WSS4J med ned, da dette modul, for nogen har givet store problemer.






Seal.java i moduler


2.1. Seal-common

Indeholder kode som bruges på tværs af IDWS og DGWS (og evt. fremtidige formater).

...

4.1. Standard SOSI-factory





a_simple_service_consumer_usage


4.2. IDWSH-factory

Fra version 2.1 inkluderer Seal.Java nu IDWSHFactory. Version 2.1 markerer begyndelsen af IDWSH-support. Det formodes at fremdidige versioner af Seal.Java vil udvide support og arbejdsgang ved hjælp af IDWSH.
Seal.Java 2.1 understøtter kun IDWSH IdentityToken. Strømmen til konstruktion og anvendelse af IdentityToken er vist nedenstående figur.

...

Når SOSIFactory er oprettet, er det let at komme i gang. Overvej følgende kodestykker, der indeholder kode til opbygning af en anmodning (request) som sendes til en tjenesteudbyder (Service provider).

5.1. Service Consumer

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

Properties properties = ...;
SOSITestFederation testFederation = new SOSITestFederation(properties);
CredentialVault credentialVault = ...; // construct or resolve credentialvault here
 
SOSIFactory factory = new SOSIFactory(testFederation, credentialVault, properties);
Request request = factory.createNewRequest(
        false, // don’t require non-repudiation receipt
        null // Optional flow-ID (not used here)
);
 
IDCard idCard = ...; // resolve ID-card here
 
request.setIDCard(idCard);
 
Element body = ...; // build body DOM element here
request.setBody(body);
 
Document domDocument = request.serialize2DOMDocument();
String xml = XmlUtil.node2String(domDocument, false, true);
//Send xml to Service provider here

Det reelle arbejde ligger i følgende linier:

...

På den "anden side" hos serviceudbyderen bruges biblioteket således. Også her håndterer udvikleren kun ting, der er relateret til forretningsopgaven.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

Properties properties = ...;
Federation federation = new SOSIFederation(properties);
CredentialVault credentialVault = ...; // construct or resolve credentialvault here
SOSIFactory factory = new SOSIFactory(federation, credentialVault, properties);
 
// This implicitely verifies the STS signature on the ID card etc.
Request request = factory.deserializeRequest(xml);
 
IDCard idCard = request.getIDCard();
 
// use ID card attributes for authorization here
 
Element body = request.getBody();
 
// use information in body for business logic here
 
Reply reply = factory.createNewReply(
        request,    // dgws version and”In response to” ID
        null        // Optional flow-ID set to null
);
 
reply.setIDCard(idCard);
 
Element replyBody = ...; // build reply body DOM element here
reply.setBody(replyBody);
 
Document domDocument = reply.serialize2DOMDocument();
String replyXML = XmlUtil.node2String(domDocument, false, true);
// Send replyXML to Service provider here






  1. Plain Old Java Objects - https://en.wikipedia.org/wiki/Plain_old_Java_object ↩