deegree 2.5 (2011/06/29 09:44 build-8-official)

deegree - Java framework for geospatial solutions

This document is the API specification of the deegree 2.5 framework - a Java framework for geospatial solutions.

See:
          Description

deegree Coordinate Reference System (crs)
org.deegree.crs The org.deegree.crs package contains all necessities to transform and project coordinates form one coordinates system into another.
org.deegree.crs.components The components package holds the shared components used by coordinatesystems, projections and transformations.
org.deegree.crs.configuration The org.deegree.crs.configuraton package contains the classes necessary to read crs-definitions from a file.
org.deegree.crs.configuration.deegree  
org.deegree.crs.configuration.gml  
org.deegree.crs.configuration.proj4  
org.deegree.crs.configuration.resources  
org.deegree.crs.coordinatesystems The coordinatesystems package holds the different coordinatesystems used by the org.deegree.crs packages.
org.deegree.crs.exceptions The exception package holds the exceptions which can be used for all crs-transforms and projections.
org.deegree.crs.projections A map projection create a 2D view of the 3D-Object 'earth', by doing so, some information is inevitably lost.
org.deegree.crs.projections.azimuthal Azimuthal projections use a plane to project the earth onto.
org.deegree.crs.projections.conic Conic projections use a cone (hence it's name) to project a region of the earth.
org.deegree.crs.projections.cylindric Cylindrical projections use a cylinder (may it be oblique or not) to create projection of a region of the earth.
org.deegree.crs.transformations A Transformation can be defined as an mathematical operation which transforms some values into other values using a specified function.
org.deegree.crs.transformations.coordinate Coordinate Transformations allow the chaining of operations to map coordinates of one coordinate systems onto a coordinate valid in another coordinate system.
org.deegree.crs.transformations.helmert A Transformation can be defined as an mathematical operation which transforms some values into other values using a specified function.
org.deegree.crs.transformations.polynomial A Transformation can be defined as an mathematical operation which transforms some values into other values using a specified function.
org.deegree.crs.utilities  

 

deegree Framework
org.deegree.framework.concurrent  
org.deegree.framework.file  
org.deegree.framework.jndi NEW Package.
org.deegree.framework.log The log package provides classes and interfaces implementing logging capabilities.
org.deegree.framework.mail NEW Package.
org.deegree.framework.trigger  
org.deegree.framework.util  
org.deegree.framework.version  
org.deegree.framework.xml  
org.deegree.framework.xml.schema  

 

deegree Enterprise Services
org.deegree.enterprise  
org.deegree.enterprise.control  
org.deegree.enterprise.control.ajax  
org.deegree.enterprise.servlet NEW Package.

 

deegree OGC Web Services (OWS)
org.deegree.ogcbase Provides common classes to deal with an OGC conform service instance.
org.deegree.ogcwebservices  
org.deegree.ogcwebservices.csw Catalog Service 2.0 (OGC CS-W Version 2.0.0).
org.deegree.ogcwebservices.csw.capabilities  
org.deegree.ogcwebservices.csw.configuration  
org.deegree.ogcwebservices.csw.discovery  
org.deegree.ogcwebservices.csw.iso_profile  
org.deegree.ogcwebservices.csw.iso_profile.ebrim  
org.deegree.ogcwebservices.csw.manager  
org.deegree.ogcwebservices.getcapabilities  
org.deegree.ogcwebservices.sos  
org.deegree.ogcwebservices.sos.capabilities  
org.deegree.ogcwebservices.sos.configuration  
org.deegree.ogcwebservices.sos.describeplatform  
org.deegree.ogcwebservices.sos.describesensor  
org.deegree.ogcwebservices.sos.getobservation  
org.deegree.ogcwebservices.sos.om  
org.deegree.ogcwebservices.sos.sensorml  
org.deegree.ogcwebservices.wass.common  
org.deegree.ogcwebservices.wass.exceptions  
org.deegree.ogcwebservices.wass.saml  
org.deegree.ogcwebservices.wass.was  
org.deegree.ogcwebservices.wass.was.capabilities  
org.deegree.ogcwebservices.wass.was.configuration  
org.deegree.ogcwebservices.wass.was.operation  
org.deegree.ogcwebservices.wass.wss  
org.deegree.ogcwebservices.wass.wss.capabilities  
org.deegree.ogcwebservices.wass.wss.configuration  
org.deegree.ogcwebservices.wass.wss.operation  
org.deegree.ogcwebservices.wcs Web Coverage Service 1.1.7 (OGC WCS Version 1.0.0).
org.deegree.ogcwebservices.wcs.configuration  
org.deegree.ogcwebservices.wcs.describecoverage  
org.deegree.ogcwebservices.wcs.getcapabilities  
org.deegree.ogcwebservices.wcs.getcoverage  
org.deegree.ogcwebservices.wcts The wcts (Web-Coordinate-Transformation-Service) package contains the deegree implementation of the wcts described in the draft version (0.4.0) of the ogc.
org.deegree.ogcwebservices.wcts.capabilities  
org.deegree.ogcwebservices.wcts.capabilities.mdprofiles  
org.deegree.ogcwebservices.wcts.configuration  
org.deegree.ogcwebservices.wcts.data  
org.deegree.ogcwebservices.wcts.operation  
org.deegree.ogcwebservices.wfs Web Feature Service (OGC WFS Version 1.1.0).
org.deegree.ogcwebservices.wfs.capabilities  
org.deegree.ogcwebservices.wfs.configuration  
org.deegree.ogcwebservices.wfs.operation  
org.deegree.ogcwebservices.wfs.operation.transaction  
org.deegree.ogcwebservices.wmps Web Map Service 1.1.3 (OGC WMS Version 1.1.1).
org.deegree.ogcwebservices.wmps.capabilities  
org.deegree.ogcwebservices.wmps.configuration  
org.deegree.ogcwebservices.wmps.operation  
org.deegree.ogcwebservices.wms Web Map Service 1.1.3 (OGC WMS Version 1.1.1).
org.deegree.ogcwebservices.wms.capabilities  
org.deegree.ogcwebservices.wms.configuration  
org.deegree.ogcwebservices.wms.dataaccess  
org.deegree.ogcwebservices.wms.operation  
org.deegree.ogcwebservices.wps  
org.deegree.ogcwebservices.wps.capabilities  
org.deegree.ogcwebservices.wps.configuration  
org.deegree.ogcwebservices.wps.describeprocess  
org.deegree.ogcwebservices.wps.execute  
org.deegree.ogcwebservices.wps.execute.processes  
org.deegree.ogcwebservices.wpvs The WPVS (Web Perspective View Service) package is the 3D analogon to a WMS (Web Map Service), it is able to generate a 3D-view of (2D or 3D) geospatial data.
org.deegree.ogcwebservices.wpvs.capabilities  
org.deegree.ogcwebservices.wpvs.configuration  
org.deegree.ogcwebservices.wpvs.j3d  
org.deegree.ogcwebservices.wpvs.operation  
org.deegree.ogcwebservices.wpvs.utils  

 

deegree Model
org.deegree.model.coverage  
org.deegree.model.coverage.grid  
org.deegree.model.coverage.grid.oracle  
org.deegree.model.coverage.grid.postgres  
org.deegree.model.crs  
org.deegree.model.feature  
org.deegree.model.feature.schema  
org.deegree.model.filterencoding  
org.deegree.model.filterencoding.capabilities  
org.deegree.model.gridprocessing  
org.deegree.model.metadata.iso19115  
org.deegree.model.spatialschema  
org.deegree.model.table  

 

deegree Datatypes
org.deegree.datatypes  
org.deegree.datatypes.parameter  
org.deegree.datatypes.time  
org.deegree.datatypes.values  
org.deegree.datatypes.xlink  

 

deegree Spatial Data Input/Output
org.deegree.io  
org.deegree.io.arcinfo_raster  
org.deegree.io.csv  
org.deegree.io.databaseloader  
org.deegree.io.datastore  
org.deegree.io.datastore.cached  
org.deegree.io.datastore.idgenerator  
org.deegree.io.datastore.schema  
org.deegree.io.datastore.schema.content  
org.deegree.io.datastore.sde  
org.deegree.io.datastore.shape  
org.deegree.io.datastore.sql  
org.deegree.io.datastore.sql.generic  
org.deegree.io.datastore.sql.idgenerator  
org.deegree.io.datastore.sql.mysql  
org.deegree.io.datastore.sql.oracle  
org.deegree.io.datastore.sql.postgis  
org.deegree.io.datastore.sql.transaction  
org.deegree.io.datastore.sql.transaction.delete  
org.deegree.io.datastore.sql.transaction.insert  
org.deegree.io.datastore.sql.wherebuilder  
org.deegree.io.datastore.wfs  
org.deegree.io.dbaseapi  
org.deegree.io.ecwapi  
org.deegree.io.geotiff  
org.deegree.io.gpx  
org.deegree.io.imgapi  
org.deegree.io.mapinfoapi  
org.deegree.io.oraclegeoraster  
org.deegree.io.quadtree  
org.deegree.io.rtree  
org.deegree.io.sdeapi  
org.deegree.io.shpapi  
org.deegree.io.shpapi.shape_new  
org.deegree.io.util NEW Package.

 

deegree Graphics
org.deegree.graphics  
org.deegree.graphics.charts  
org.deegree.graphics.displayelements  
org.deegree.graphics.legend  
org.deegree.graphics.optimizers  
org.deegree.graphics.sld  
org.deegree.graphics.transformation  

 

deegree Portal
org.deegree.portal  
org.deegree.portal.cataloguemanager.control  
org.deegree.portal.cataloguemanager.model  
org.deegree.portal.cataloguemanager.servlet  
org.deegree.portal.common  
org.deegree.portal.common.control  
org.deegree.portal.context  
org.deegree.portal.owswatch  
org.deegree.portal.owswatch.configs  
org.deegree.portal.owswatch.validator  
org.deegree.portal.portlet.enterprise  
org.deegree.portal.portlet.jsp.taglib  
org.deegree.portal.portlet.modules.actions  
org.deegree.portal.portlet.modules.map.actions.portlets  
org.deegree.portal.portlet.modules.security.actions.portlets  
org.deegree.portal.portlet.modules.wfs.actions.portlets  
org.deegree.portal.portlet.portlets  
org.deegree.portal.standard  
org.deegree.portal.standard.context.control  
org.deegree.portal.standard.csw  
org.deegree.portal.standard.csw.configuration  
org.deegree.portal.standard.csw.control  
org.deegree.portal.standard.csw.model  
org.deegree.portal.standard.gazetteer  
org.deegree.portal.standard.security.control  
org.deegree.portal.standard.sos  
org.deegree.portal.standard.sos.configuration  
org.deegree.portal.standard.sos.control  
org.deegree.portal.standard.wfs  
org.deegree.portal.standard.wfs.configuration  
org.deegree.portal.standard.wfs.control  
org.deegree.portal.standard.wmps  
org.deegree.portal.standard.wms  
org.deegree.portal.standard.wms.control  
org.deegree.portal.standard.wms.control.layertree  
org.deegree.portal.standard.wms.util  
org.deegree.portal.wac  

 

deegree Security Framework
org.deegree.security  
org.deegree.security.drm  
org.deegree.security.drm.model  
org.deegree.security.owsproxy  
org.deegree.security.owsrequestvalidator  
org.deegree.security.owsrequestvalidator.csw  
org.deegree.security.owsrequestvalidator.wfs  
org.deegree.security.owsrequestvalidator.wms  
org.deegree.security.session  

 

deegree Standalone Tools
org.deegree.tools.app3d  
org.deegree.tools.datastore  
org.deegree.tools.importer  
org.deegree.tools.legend  
org.deegree.tools.raster  
org.deegree.tools.security  
org.deegree.tools.shape  
org.deegree.tools.srs  
org.deegree.tools.wms  
org.deegree.tools.xml  

 

Other Packages
org.deegree.i18n  
org.deegree.owscommon  
org.deegree.owscommon_1_1_0 This package is able to read and write xml encoded documents which validate against the ows common 1.1.0 schema package.
org.deegree.owscommon_1_1_0.operations  
org.deegree.owscommon_new  
org.deegree.owscommon.com110  
org.deegree.processing.raster  
org.deegree.processing.raster.converter  
org.deegree.processing.raster.filter  
org.deegree.processing.raster.interpolation  

 

This document is the API specification of the deegree 2.5 framework - a Java framework for geospatial solutions.

Attention! All types and names are subject of change!

[Specification] [Documentation] [Platform] [Architecture] [Design Aspects] [Extended JavaDoc tags] [Project Reports]

Specification

The basic idea about deegree is to provide a framework, allowing flexible implementations of geospatial solutions ranging from standalone applications to highly distributed and service-based infrastructures. Deegree is reusable, platform independend, component-based, and interoperable. To meet the interoperability requirement deegree is based on OGC's WMS, WFS and GridCoverage Specifications and on the ISO 19107 datamodel.
ISO 19107:2003 specifies conceptual schemas for describing the spatial characteristics of geographic features, and a set of spatial operations consistent with these schemas.

[ ^ ]


Related Documentation

For overviews, tutorials, examples, guides, and tool documentation, please see:

[ ^ ]


Used Platform, Tools and Frameworks

The deegree 2.5 framework is using the following third-party libraries (the list is by far not complete):

Optional:

deegree 2.5 requires the following platform: Java 2 SDK, Enterprise Edition (J2EE) 1.5 with Java 2 Platform, Standard Edition (J2SE) 1.5

[ ^ ]


Architecture

Service-oriented Architecture (SOA)
A service is a distinct part of the functionality that is provided by an entity through interfaces [ISO/IEC TR 14252]

WMS - Web Map Service: Provides four protocols (GetCapabilities, GetMap, GetFeatureInfo and DescribeLayer) in support of the creation and display of registered and superimposed map-like views of information that come simultaneously from multiple sources that are both remote and heterogeneous.
WFS - Web Feature Service: The purpose of the Web Feature Server Interface Specification (WFS) is to describe data manipulation operations on OpenGIS� Simple Features (feature instances) such that servers and clients can communicate at the feature level.
CSW - Catalog Service for Web: Defines a common interface that enables diverse but conformant applications to perform discovery, browse and query operations against distributed and potentially heterogeneous catalog servers.
WCS - Web Coverage Service: Extends the Web Map Server (WMS) interface to allow access to geospatial "coverages" that represent values or properties of geographic locations, rather than WMS generated maps (pictures).
SOS - The basic function of the Sensor Observation Service (SOS) is to provide a web-enabled interface to a sensor, collection of sensors or sensor proxy. Sensors are defined as devices that measure physical quantities.
Patterns
...
Patterns library
Fundamental Design Patterns
Java Software Patterns
Java Enterprise Design Patterns
J2EE patterns

[ ^ ]


Design Aspects

Exception handling
Exception, TODO: Central Error handling, support for multi language/internationalization missings
Logging
Logging
Profiling
Profiling of resource usage (memory, CPU, threads)
Profiling
Security
TODO

[ ^ ]


Extended JavaDoc tags

Some of these tags were presented in the article "AmbySoft Inc. Java Coding Standards", by Scott W. Ambler.
@bug - describes a known bug
Describes a known bug related to the class, method or routine.
@todo - marks that the item isn't finished yet
This is info for the coders (only) of the class, method or routine. A @todo is something which is meant to be fixed before the next release. It is not the same as @bug, because a bug may be too expensive to fix, or otherwise does not warrant it being fixed. A @todo is often "stronger" than @bug, but not necessarily so. Use one tag per "todo". Can be used everywhere.
@precondition - documents a precondition
Documents a precondition. Applies to methods and routines, and sometimes to properties. A precondition is a statement which is assumed true when the method gets called. It is part of the contract between the caller and callee, with the "burden" on the caller. A good practice is to assert the preconditions of a method.
@postcondition - documents a postcondition
Documents a postcondition. Applies to methods and routines, and sometimes to properties. A postcondition is a statement which you as a caller can assume to be true when the method (etc) returns. It is part of the contract between the caller and callee, with the "burden" on the callee.

[ ^ ]


Project Reports

[ ^ ]


Version:
$Revision: 28331 $, $Date: 2010-11-22 12:15:51 +0100 (Mo, 22 Nov 2010) $
Author:
Torsten Friebe, $Author: jmays $
See Also:
deegree test suite JavaDoc

deegree 2.5 (2011/06/29 09:44 build-8-official)

an open source project founded by lat/lon, Bonn, Germany.
For more information visit: http://www.deegree.org