nl.b3p.kaartenbalie.service.requesthandler

Class OGCRequestHandler

java.lang.Object

nl.b3p.kaartenbalie.service.requesthandler.OGCRequestHandler

All Implemented Interfaces:

RequestHandler

Direct Known Subclasses:

WFSRequestHandler, WMSRequestHandler

public abstract class OGCRequestHandler
extends Object
implements RequestHandler

Field Summary

Fields

Modifier and Type	Field and Description
protected int	maxResponseTime
protected String	url
protected User	user

Constructor Summary

Constructors

Constructor and Description
OGCRequestHandler()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addToServerProviderList(List<nl.b3p.ogc.utils.SpLayerSummary> eventualSPList, nl.b3p.ogc.utils.SpLayerSummary layerInfo, boolean maintainOrder) methode om nieuwe layer toe te voegen aan lijst met service providers. eerst wordt de laatste service provider opgezocht. als de nieuwe layer bij deze service provider hoort dan kan de layer aan deze service provider worden toegevoegd.
protected abstract LayerPriceComposition	calculateLayerPriceComposition(DataWrapper dw, ExtLayerCalculator lc, String spAbbr, String layerName) abstracte methode die voor wms en wfs specifiek geimplmenteerd word.
protected void	configB3pLayering(List<nl.b3p.ogc.utils.LayerSummary> lsl, Map config) methode doorloopt alle layers om te zien of er service layers bij zitten (b3playering). als zo'n layer wordt gevonden dan wordt de processConfig van die service layer aangeroepen.
void	doAccounting(Integer orgId, DataWrapper data, User user) methode sluit transactie van AccountManager af waarbij alle aangemelde betalingen daadwerkelijk worden afgeboekt en de transactie wordt gesloten.
protected nl.b3p.wms.capabilities.Layer	getLayerByUniqueName(String uniqueName)
int	getMaxResponseTime()
protected List	getServiceProviderURLS(List<nl.b3p.ogc.utils.LayerSummary> lsl, Integer[] orgIds, boolean checkForQueryable, DataWrapper dw, boolean maintainOrder) methode is complexer dan op het eerste gezicht nodig lijkt. per service provider worden de layers opgezocht. echter de volgorde van de layers moet bewaard blijven.
protected abstract nl.b3p.ogc.utils.SpLayerSummary	getValidLayerObjects(javax.persistence.EntityManager em, nl.b3p.ogc.utils.LayerSummary m, Integer[] orgIds, boolean b3pLayering) abstracte methode die door implementatie van handler moet worden gedefinieerd.
protected nl.b3p.ogc.utils.SpLayerSummary	getValidLayerObjects(javax.persistence.EntityManager em, String query, nl.b3p.ogc.utils.LayerSummary m, Integer[] orgIds, boolean b3pLayering) methode die alleen een query nodig heeft om bestaan en rechten van layer te bepalen.
boolean	isConfigInUrlAndAdmin(DataWrapper data, User user)
protected List<nl.b3p.ogc.utils.SpLayerSummary>	prepareAccounting(Integer orgId, DataWrapper dw, List<nl.b3p.ogc.utils.SpLayerSummary> foundSpList) deze methode doorloopt alle service providers en daarbinnen weer alle layers om vast te stellen of er betaling noodzakelijk is. de bepaalde beprijzing wordt opgenomen in een transactie van de AccountManager. later wordt de daadwerkelijke afrekening geeffectueerd als het vervolgproces goed verlopen is.
void	setMaxResponseTime(int maxResponseTime)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface nl.b3p.kaartenbalie.service.requesthandler.RequestHandler

getRequest, mayDirectWrite

Field Detail

user

protected User user

url

protected String url

maxResponseTime

protected int maxResponseTime

Constructor Detail

OGCRequestHandler

public OGCRequestHandler()

Method Detail

getValidLayerObjects

protected abstract nl.b3p.ogc.utils.SpLayerSummary getValidLayerObjects(javax.persistence.EntityManager em,
                                                   nl.b3p.ogc.utils.LayerSummary m,
                                                   Integer[] orgIds,
                                                   boolean b3pLayering)
                                                                 throws Exception

abstracte methode die door implementatie van handler moet worden gedefinieerd. feitelijke moet alleen de juiste query gedefinieerd te worden waar dan de volgende invoerparameters bijhoren:

• orgId
• layerName
• layerCode (ofwel spAbbr)

als resultaat moet de query de volgende kolommen geven:

• layerQueryable
• serviceproviderId
• layerId
• layerName
• spUrl
• spAbbr

het echte werkt wordt gedaan door de volgende methode

Parameters:

em - EntityManager

layer - layer naam met sp abbrr (abbr_layer)

orgId - organisatie id

b3pLayering - bepaalt of service layers toegevoegd worden, true = alleen service layers, false = alleen echte layers.

Returns:

object array met resultaat voor gezochte layer

Throws:

Exception - indien gezochte layer niet bestaat of er geen rechten op zijn

See Also:

getValidLayerObjects(EntityManager em, String query, String layer, Integer orgId, boolean b3pLayering) throws Exception

getValidLayerObjects

protected nl.b3p.ogc.utils.SpLayerSummary getValidLayerObjects(javax.persistence.EntityManager em,
                                                   String query,
                                                   nl.b3p.ogc.utils.LayerSummary m,
                                                   Integer[] orgIds,
                                                   boolean b3pLayering)
                                                        throws Exception

methode die alleen een query nodig heeft om bestaan en rechten van layer te bepalen.

Parameters:

em - EntityManager

query - query waarmee rechten en bestaan gecheckt kan worden

m -

orgIds -

b3pLayering - bepaalt of service layers toegevoegd worden, true = alleen service layers, false = alleen echte layers.

spAbbrUrl -

Returns:

object array met resultaat voor gezochte layer

Throws:

Exception - indien gezochte layer niet bestaat of er geen rechten op zijn

See Also:

getValidLayerObjects(EntityManager em, String query, String layer, Integer orgId, boolean b3pLayering) throws Exception

isConfigInUrlAndAdmin

public boolean isConfigInUrlAndAdmin(DataWrapper data,
                            User user)

getServiceProviderURLS

protected List getServiceProviderURLS(List<nl.b3p.ogc.utils.LayerSummary> lsl,
                          Integer[] orgIds,
                          boolean checkForQueryable,
                          DataWrapper dw,
                          boolean maintainOrder)
                               throws Exception

methode is complexer dan op het eerste gezicht nodig lijkt. per service provider worden de layers opgezocht. echter de volgorde van de layers moet bewaard blijven. als voor een service provider meerdere layers voorkomen, maar tussen deze layers zitten andere layers van andere service providers, dan dient de service provider meerdere keren opgenomen te worden. later wordt dan ook meerdere keren een call naar deze zelfde service provider gedaan.

een en ander is nodig bij map images om layers in exact de juiste volgorde op elkaar te plaatsen. bij featureinfo dient de volgorde in het xml ook overeen te komen met de volgorde in de request.

er zijn 2 soorten layers: normale layers zoals deze door de gebruiker zijn geselecteerd en service layers (b3playering) welke gebruikt worden door kaartenbalie om gebruikers in de gelegenheid te stellen afrekenen toe te staan, hun credit hoeveelheid te zien en om over-head-display foutmeldingen te geven. de layers van b3playering worden altijd boven op geplaatst, zodat de layers 2x door lopen moeten worden.

Parameters:

layers - array van layers waarvan de serviceprovider moet worden opgezocht

orgId - organbisatie id

checkForQueryable - true = zoek alleen layers die queryable zijn

dw - datawrapper

Returns:

lijst van serviceproviders met daarin bij behorende layers

Throws:

Exception - fout bij ophalen layer informatie

calculateLayerPriceComposition

protected abstract LayerPriceComposition calculateLayerPriceComposition(DataWrapper dw,
                                                   ExtLayerCalculator lc,
                                                   String spAbbr,
                                                   String layerName)
                                                                 throws Exception

abstracte methode die voor wms en wfs specifiek geimplmenteerd word.

Parameters:

dw - datawrapper

lc - LayerCalculator bepaalt de calculatie methode

layerId - laag id waarvoor prijs berekend moet worden

Returns:

geeft prijs

Throws:

Exception - fout bij prijsbepaling

prepareAccounting

protected List<nl.b3p.ogc.utils.SpLayerSummary> prepareAccounting(Integer orgId,
                                                      DataWrapper dw,
                                                      List<nl.b3p.ogc.utils.SpLayerSummary> foundSpList)
                                                           throws Exception

deze methode doorloopt alle service providers en daarbinnen weer alle layers om vast te stellen of er betaling noodzakelijk is. de bepaalde beprijzing wordt opgenomen in een transactie van de AccountManager. later wordt de daadwerkelijke afrekening geeffectueerd als het vervolgproces goed verlopen is.

indien wel betaling noodzakelijk is, maar er is geen toestemming of credit dan wordt een over-head-display image aangemaakt met melding.

Parameters:

orgId - organisatie id

dw - datawrapper

foundSpList - lijst van service providers die doorlopen moet worden

Returns:

opgeschoonde lijst van layers die getoond mogen worden.

Throws:

Exception - fout bij bepaling prijs

doAccounting

public void doAccounting(Integer orgId,
                DataWrapper data,
                User user)
                  throws Exception

methode sluit transactie van AccountManager af waarbij alle aangemelde betalingen daadwerkelijk worden afgeboekt en de transactie wordt gesloten.

Parameters:

orgId - organisatie id

data - datawrapper

user - user object

Throws:

Exception - fout bij afronden transactie

getLayerByUniqueName

protected nl.b3p.wms.capabilities.Layer getLayerByUniqueName(String uniqueName)
                                                      throws Exception

Throws:

Exception

addToServerProviderList

protected void addToServerProviderList(List<nl.b3p.ogc.utils.SpLayerSummary> eventualSPList,
                           nl.b3p.ogc.utils.SpLayerSummary layerInfo,
                           boolean maintainOrder)

methode om nieuwe layer toe te voegen aan lijst met service providers. eerst wordt de laatste service provider opgezocht. als de nieuwe layer bij deze service provider hoort dan kan de layer aan deze service provider worden toegevoegd. Als de nieuwe layer bij een andere service provider hoort, dan moet een nieuwe service provider worden aangemaakt en de layer hier aan toe gevoegd worden.

een nieuwe layer mag niet aan een eerder in de lijst geplaatste service provider worden toegevoegd (ook al is dat wel de zelfde) omdat dan de volgorde van de layers niet meer klopt. Consequentie is dat service providers soms meerdere keren worden aangeroepen.

Parameters:

eventualSPList - lijst met service providers in juiste volgore

layerInfo -

maintainOrder -

configB3pLayering

protected void configB3pLayering(List<nl.b3p.ogc.utils.LayerSummary> lsl,
                     Map config)
                          throws Exception

methode doorloopt alle layers om te zien of er service layers bij zitten (b3playering). als zo'n layer wordt gevonden dan wordt de processConfig van die service layer aangeroepen. Deze processConfig kan dan informatie toevoegen aan de algemene config map.

de service layer AllowTransactionsLayer plaatst bv een boolean in de config map, zodat verder op de accouting methodes weten dan de gebruiker afrekenen heeft toegestaan.

Parameters:

layers - lijst van alle layers

config - map met configuratie info

Throws:

Exception - fout bij configureren

getMaxResponseTime

public int getMaxResponseTime()

Returns:

the maxResponseTime

setMaxResponseTime

public void setMaxResponseTime(int maxResponseTime)

Parameters:

maxResponseTime - the maxResponseTime to set