Iwan7 - Konfiguration

Die Konfiguration ist minimal. Der Port und das Basis-Verzeichnis wird beim Starten übergeben (entweder interaktiv oder als Dienst-Argument).

Folgende Parameter müssen angegeben werden:

-port: Die Portnummer, an der der Http Listener läuft (empfohlener Wert: 8287)

-baseDir: Das Basis-Verzeichnis für die (Projekt) Konfigurationsdateien

Globale Standard-Parameter

Zur Laufzeit können diese Parameter durch Aufruf an /config modifiziert werden.

Wenn die Werte null sind (empfohlen), werden die "besten" Standardeinstellungen gesetzt. Diese können sich von Version zu Version unterscheiden.

{
    /*
    Trace-Level (TraceError)
    einer der Werte: 
       TraceNone
	   TraceWarning,
	   TraceError,
	   TraceInfo,
	   TraceDebug,
	   TraceDetail,
	   TraceDetailEx
    */
    
    "traceLevel": null,

    /*
    Zeichen-Modi (UseVectorQueue,RenderLayersParallel)
    eine Kombination der Wert:
        NoParallel
        RenderLayersParallel,
        UseVectorQueue,
        DebugRenderSkipVRendering
    */

    "renderMode":null,

    /*
    Optimierung für komplexe Polygone (true) (siehe ShapeFile)
    */
    
    "enableComplexPolyRenderCache":null,

    /*
    Grafik-Engine (Agge)
    einer der Werte:
        GdiPlus,
        Direct2d,
        Agge    
    */

    "renderEngine":null

    /*
    Objekt, mit Proxy-Einstellungen (*1)

     {
        proxyUri:"http://localhost:8888",
        useDefaultProxy:false,
        proxyBypassList:null,
        proxyCredentials:{
            "userName":"usr",
            "passWord":"\encrypted..."
           }
     }
    */

    "defaultProxy": null

    /*
    Liste mit Bounding-Boxes, die für das Schätzen von EPSG Codes verwendet wird.
    Wenn nicht angegeben, dann sind dies die Standardwerte: (siehe unten unter CRSEstimates):
    */
    "CRSEstimates":null
}

(*1) Die Proxy-Einstellungen werden derzeit noch nicht verwendet und sind für zukünftige Anwendungszwecke gedacht.

Projektspezifische Konfigurationen

Projekte dienen der Isolation von Ebenen untereinander. Meist ist solch ein Projekt mit einer cardo Instanz assoziiert. Der Projektname kann/muss in jedem Request mit übergeben werden.

Die Projektdateien sind ebenfalls im baseDir zu finden. Der Name der Datei ist immer in der Form .config anzugeben.

Ein Sonderfall ist dabei die Datei $default.config.

Beim Starten des Servers werden alle *.config Dateien in baseDir eingelesen. Die so ermittelten Dateien definieren gleichzeitig die verfügbaren Projektnamen.

{
     "workingDir":null,
     "tempDir":null,
     "projectBBox":null
}

• workingDir: Das Arbeitsverzeichnis, relative Pfadangaben werden zu diesem ausgewertet, wenn nicht angegeben, dann identisch mit baseDir

• tempDir: Verzeichnis für temporäre Dateien, wenn nicht angegeben, dann wird workingDir/tempFiles angenommen.

• projectBBox: Die Standard-Boundingbox für das jeweilige Projekt als Objekt in der Form {minx, "miny":number,"maxx":number,"maxy":number,"epsgCode":number} Geplant ist, beim Rendern den Pinsel-Ursprung auf die linke untere Ecke dieser Boundingbox auszurichten.

nur in der $default.config:

• allowAccessToUndefinedProjects: Wenn false (der Standardwert), dann wird bei Aufrufen an an nicht vorhandenes Projekt der Fehler "Es ist keine Definition für ein Projekt XY vorhanden" ausgelöst.

• CRSEstimates: Hiermit kann die Liste für die auto-Ermittlung der EPSG Codes explizit angegeben werden. Zum Testen kann /json/estimateCrs/ verwendet werden (Bsp.: http://localhost:8287/iwan/json/estimateCrs?x=12&y=51).

  Die Einstellungen werden nur bei json/WriteConfig oder beim Serverstart ausgelesen. Alternativ kann mit Aufruf von json/reloadConfig das Neuladen ausgelöst werden.

  Die Standardwerte sind:

  {
       "useFallbackIfNotFound":false,
        "bbox":[
    	    {"epsgCode":31468,"minx":4300000,"maxx":4999999    ,"miny":0,"maxy":0},
    	    {"epsgCode":31469,"minx":5000000,"maxx":5999999    ,"miny":0,"maxy":0},
    	    {"epsgCode":25833,"minx":200000 ,"maxx":599999     ,"miny":0,"maxy":0},
    	    {"epsgCode":25832,"minx":600000 ,"maxx":801486     ,"miny":0,"maxy":0},
    	    {"epsgCode":31467,"minx":3200000,"maxx":3700000    ,"miny":0,"maxy":0},
    	    {"epsgCode":4326 ,"minx":-180,"maxx":180           ,"miny":0,"maxy":0},
    	    {"epsgCode":4647 ,"minx":32354333,"maxx":32683279  ,"miny":0,"maxy":0},
    	    {"epsgCode":5650 ,"minx":33000000,"maxx":33900000  ,"miny":0,"maxy":0},
    	    {"epsgCode":3068 ,"minx":2816.9273,"maxx":49855.0971,"miny":300.1350,"maxy":39377.9521},
        ]
    }
  

  Bei der Auswertung gilt: Wenn die Werte der Achse 0 sind, gilt der vergleich aus "Wahr" (minx=0, maxx=0 => keine Auswertung in x-Richtung, gleiches für y).

  Wenn useFallbackIfNotFound:true angegeben wird und in den eigenen Einstellungen kein Treffer ermittelt wird, wird mit dem hier gezeigtem Standardwerten weiter gesucht.

  Wenn der epsgCode 0 definiert wird, dann gilt die Projektion als nicht-erkannt. Damit kann für Konfliktsituationen die Schätzung deaktiviert werden.

  Das Gleiche gilt, wenn das Array der BBox-Liste leer ist und useFallbackIfNotFound:true angegeben wird. Damit kann die automatische Schätzung faktisch deaktiviert werden.