Sidjämförelse

...

För att tillmötesgå kravet på enkel installation av nya virtuella tjänster paketeras varje virtualiserad tjänst som en komponent. Denna komponent (paketerad virtuell tjänst) hör samman med det tjänstekontrakt den virtualiserar snarare än en specifik instans av virtualiseringsplattformen. Den kan sedan installeras i alla förekommande driftsinstanser av virtualiseringsplattformen utan någon ytterligare konfiguration. som tillförs ESB'n. Vägvalsroutern är den komponent som alla virtualiserade tjänster kommunicerar med via ett internt protokoll.

Image RemovedImage Added

Den virtuella tjänsten exponerar en anslutningspunkt in till vår ESB för ett visst tjänstekontrakt. Vid ett anrop från en tjänstekonsument anropas virtualiseringsplattformen internt med ett meddelande som innehåller all inkommande information. Virtualiseringsplattformen exponerar en intern anslutningspunkt för inkommande anrop från den virtuella tjänsten. Alla virtuella tjänster skickar anropen vidare till samma interna anslutningspunkt. En routing sker i virtualisringsplattformen till en extern tjänsteproducent när alla villkor för denna routing är uppfyllda.Om villkoren inte är uppfyllda returneras ett SoapFault. Virtualiseringsplattformen anropar tjänstekatalogen för att få nödvändig virtualiserings- och behörighetsinformation vid uppstart av ESB'n.

...

Virtualiseringsplatformen

<<< Bild över komponenter i VP >>>

...

Paketstrukturer för virtualiseringsplattformen

se.skl.tp.virtualisering

...

Nedan redovisas de mest intressanta paketstrukturerna.

se.skl.tp.virtualisering.exceptionvp

VpSematiskException - kastas typiskt vid felkonfiguration, behörighet saknas mm
VpTechnicalException - kastas vid runtime fel

se.skl.tp.virtualisering.transformer

ExceptionTransformer - formatterar om exceptions till konsumenten
ObjectArrayToStreamXmlTransformer - skall bort i framtida versionerexceptions - olika definerade fel som används i VP
util - Utilities som används av övriga komponenter i VP
vagvalagent - hanterar TAK information som behövs för att göra routing och behörighetskontroll
vagvalrouter - gör själva routingen i VP

se.skl.tp.

...

hsa

VagvalAgent - vägvalsagenten
MuleStartupNotificationHandler – initerar vägvalsagenten vid uppstart
SokVagvalsInfoTestStub - möjliggör test med en stubbad sökvagvalstjänst
VagvalInfo - används av SokVagvalsInfoTestStub för att kunna simulera konfiguration i tjänstekatalogen

Intern inkommande anslutningspunkt

...

cache - hanterar HSA information som används för att hitta verksamheter i en trädstruktur.

Intern inkommande "anslutningspunkt"

Den inkommande "anslutningspunkten" definieras med följande konfiguration som definierar ett Mule flöde (många detaljer är utelämnade).

Kodblock

language	xml

<model name="vagval-router">
	<service name="VagvalRouter">
		<inbound>
			<inbound-endpoint address="vm://vagval-router"
				synchronous="true">
				<response-transformers>
					<custom-transformer
						class="se.skl.tp.virtualisering.transformer.ExceptionTransformer" />
				</response-transformers>
			</inbound-endpoint>
		</inbound>
		<outbound>
			<custom-outbound-router<mule ... >
    <flow name="vagval-dynamic-routing-flow" >

		<transformer ... />
	
		<custom-processor class="se.skl.tp.virtualiseringvp.vagvalrouter.VagvalRouter">
				<spring:property name="vagvalAgent" ref="vagvalAgent" />
				<spring:property name="senderIdPropertyName" value="${tp.senderIdPropertyName}" />
	...
		</custom-outbound-router>processor>
	
		</outbound><response>
	</service>
</model>

Inkommande endpoint är den intern anslutningspunkt som nämnts tidigare dit alla virtuella tjänster skickar sina anrop. Den är en virtuell kö som Mule intern implementerar på ett mycket effektivt sätt.

ExceptionTransformer

ExceptionTransformer är en klass som kontrollerar om det kastats någon exception av typ VpSematicException eller VpTechnicalException (virtualiseringsplattformens egen-definierade exceptions). I så fall formateras returmeddelandet om så att det klienten får feltexten från original exceptionen i sitt SoapFault.

VagvalRouter

VagvalRouter är en klass som

Sammanställer all indata till vägvalet
- Receiver - från RivHeadern.
- Sender - från konsumentens certifikat, SERIALNUMBER i subject-attributet.
- RIV-TA-profil - från den virtuella tjänstens konfigurationsfil.
- Tjänstekontrakt - från den virtuella tjänstens konfigurationsfil.
- Dagens datum
Anropar Vägvalsagenten för att få en lista på möjliga vägval(Logiska adresser) baserat på Tjänstekontrakt, Receiver och Sender..
Plockar det vägval som har matchande RIV-TA-profil
Skickar anropet vidare till den adress som vägvalet hade konfigurerat i Tjänstekatalogen.

VagvalRouter har också en enkel property injicerad senderIdPropertyName som avgör vilket delfält i subjectattributet som skall parsas fram för att identifiera konsumenten. Bör vara satt till tp.senderIdPropertyName=SERIALNUMBER i den externa property filen.

VagvalAgent

VagvalRouter har en VagvalAgent injicerad. VagvalAgent är en klass som cachar all vägval genom att anropa tjänstekatalogen och svarar på frågor om vilka vägval som matchar en viss kombination av sender, receiver, tjänstekontrakt och datum. Vägvalsagenten definieras via följande konfiguration

Kodblock

language	xml

<spring:bean name="vagvalAgent" class="se.skl.tp.virtualisering.vagvalagent.VagvalAgent">
  <spring:property name="endpointAddress" value="${tp.sokVagvalsInfo.url}"/>
</spring:bean>

Adressen till tjänstekatalogen service skall finnas i den externa property filen. Vägvalsagenten notifieras när Mule startar så att den kan göra en initial laddning av vägval från tjänstekatalogen.

Kodblock

language	xml

<spring:bean name="muleStartupNotification" class="se.skl.tp.virtualisering.vagvalagent.MuleStartupNotificationHandler”>
  <spring:property name="vagvalAgent" ref="vagvalAgent"/>
</spring:bean>


<notifications>
  <notification event="CONTEXT"/>
  <notification-listener ref="muleStartupNotification"/>
</notifications>

Gemensamt hjälpbibliotek

Projektet heter tp-util.

Gemensamt schemabibliotek

Projektet heter tp-schemas.

Certifikat

Det certifikat och truststore som VP använder pekas ut via följande konfiguration som i sin tur styrs av den externa propertyfilen.

Kodblock

language	xml

<https:connector name="myHttpsConnector" clientSoTimeout="8000" >
  <https:tls-client path="${tp.tls.store.location}/tp.jks" storePassword="${tp.tls.store.password}"/>
  <https:tls-key-store path="${tp.tls.store.location}/tp.jks"storePassword="${tp.tls.store.password}" keyPassword="${tp.tls.store.password}" />
  <https:tls-server path="${tp.tls.store.location}/truststore.jks" storePassword="$ {tp.tls.store.password}" requireClientAuthentication="true"/>
</https:connector>

Externa properties

Genom följande konfiguration tas den externa propertyfilen tp-vitualisering-override.props in

Kodblock

language	xml

<context:property-placeholder location="classpath:tp-virtualisering.props, classpath*:tp-virtualisering-override.props" />

		...
		</response>
   
		<catch-exception-strategy>
		...
		</catch-exception-strategy>
    </flow>
</mule>

VP + virtualiserade tjänster

För att ha en enda konfigurationsfil när mule startas så finns en fil som heter tpvp-virtualisering-PRODconfig.xml. Den laddar dels tp-virtualisering-config.xml (med allt ovanstående) + alla virtualiserade dels egna konfigurationsfiler och dels alla virtualiserade tjänster den kan hitta på classpathen. Bygger Detta bygger på att alla virtualiserade tjänster har valt rätt namn på sin configurationsfil nämligen tp-virtuell-tjanst-confignamngivit sin konfigurationsfil med följande namn tp2-service-mule-descriptor.xml

Kodblock

language	xml

<spring:beans>
  <spring:import resource="classpath:tp-virtualisering-config.xml"/>...
  <spring:import resource="classpath*:tptp2-virtuellservice-tjanstmule-configdescriptor.xml"/>
</spring:beans>

Monitorering

...

Genom anrop av denna tjänst kan man på ett enkelt sätt kontrollera att virtualiseringsplattfomen VP inte har avslutats. Anropet sker via http://<host>:20000/monitor/ping. Pingtjänsten konfigureras i mule på följande sätt:

...

<service name="pingService">
  <inbound>
    <http:inbound-endpoint address="http://${tp.host}:${tp.ping.port}/${tp.ping.uri}" synchronous="true">
      <response-transformers>
        <expression-transformer>
          <return-argument expression="${tp.ping.response}" evaluator="string"/>
        </expression-transformer>
      </response-transformers>
    </http:inbound-endpoint>
  </inbound>
</service>

Referensapplikation

I RIV TA finns en referensapplikation som mha en tjänst kan påvisa kommunikation mellan en tjänstekonsument och en tjänsteproducent.

...

Innehåller den konfigurations-fil som alla virtualiserade tjänster måste ha: tp-virtuell-tjanstconfig. xml. Projektet innehåller även tjänsteinteraktionens wsdl, tjänstescheman och meddelandescheman, samt WS-addressing-core-schema. När man bygger detta projekt paketeras en jar. Denna jar representerar en virtuell tjänst och syftar till att installeras på virtualiseringsplattformen.

Meddelande struktur

Alla meddelande strukturer som används av tillförda virtualiserade tjänster följer RIV-TA-profilen. Meddelande formatet åtföljer WSDL bekrivningen för en virtuell tjänst.

SökVägvalsInfo

Denna tjänst använder ett internt meddelande format enligt bilden nedan.Image Removed

Exceptions

Felsituationer rapporteras av virtualiseringsplattformen enligt /wiki/spaces/SKLTP/pages/3187836516 . Om ett fel uppstår loggas det och ett VpSemanticException kastas. Det görs senare om till SoapFaultException vilket är den exception som når klienten.

...

Eftersom virtualiseringsplattformen är baserad på Mule används mekanismerna i Mule för att styra loggning. Mule använder log4j vilket beskrivs i http://ricston.com/blog/?p=81. Ett förslag på log4j.properties är som följer

Kodblock

language	text

# Default log level
log4j.rootCategory=INFO,file
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=../logs/vp.log
log4j.appender.file.MaxFileSize=10MB
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%-5p %d [%t] %c: %m%n
################################################
# You can set custom log levels per-package here
################################################
# Apache Commons tend to make a lot of noise which can clutter the log.
log4j.logger.org.apache=WARN
# Shuts up some innocuous messages if using the JBPM transport
log4j.logger.org.hibernate.engine.StatefulPersistenceContext.ProxyWarnLog=ERROR
# Reduce startup noise
log4j.logger.org.springframework.beans.factory=WARN
# Mule classes
log4j.logger.org.mule=WARN
log4j.logger.com.mulesource=WARN
# Your custom classes
log4j.logger.se.skl.tp=WARN

För att styra loggnivåer i virtualiseringsplattformen är det alltså sista raden som ändras till INFO eller DEBUG. Loggningen skapas i en fil som heter vp.log och ligger i foldern logs under MULE_HOME. Man kan också styra hur Mule själv loggar som står beskrivet i Readme under logs i muledistributionen "Application-level logging is configured in the file "conf/log4j.properties" (by default all output is sent to the console). System-level logging is configured in the file "conf/wrapper.conf" (by default all output is sent to the file "logs/mule.log" Note that, unless the application is run in the foreground (i.e., not as a daemon), this means that while the application itself is configured to send its output to the console, the wrapper receives the console output and sends it to the log file. In addition to the application's output, the wrapper also sends any JVM-level or OS-level errors/warnings to the log file. This means that if the JVM crashes and automatically restarts (enabled by default), the time and cause of the crash will remain in the log file after the JVM restarts."

Jämförda versioner

Gammal version 30

Ny version 31

Nyckel

Virtualiseringsplatformen

Paketstrukturer för virtualiseringsplattformen

Intern inkommande anslutningspunkt

Intern inkommande "anslutningspunkt"

ExceptionTransformer

VagvalRouter

VagvalAgent

Gemensamt hjälpbibliotek

Gemensamt schemabibliotek

Certifikat

Externa properties

VP + virtualiserade tjänster

Monitorering

Referensapplikation

Meddelande struktur

SökVägvalsInfo

Exceptions