com.luciad.wms.server

OGC ServerClass ALcdWMSCommandDispatcher

java.lang.Object

com.luciad.wms.server.ALcdWMSCommandDispatcher

All Implemented Interfaces:

ILcdDisposable, AutoCloseable

Direct Known Subclasses:

TLcdOGCWMSCommandDispatcher

public abstract class ALcdWMSCommandDispatcher
extends Object
implements ILcdDisposable

Abstract class for a command dispatcher implementation. It interprets HttpServletRequests and sends an appropriate response on the HttpServletResponse object.

Constructor Summary

Constructors

Constructor and Description
ALcdWMSCommandDispatcher()

Method Summary

Modifier and Type	Method and Description
void	dispose() Disposes of this object and allows it to release any system resources that it is holding.
protected TLcdGXYViewBufferedImage	getGXYView() Deprecated. This method is not used.
protected int	getGXYViewPoolSize() Returns the number of views within the pool.
protected String	getParameterIgnoreCase(String aParameterName, javax.servlet.http.HttpServletRequest aRequest) Gets the value for a named parameter ignoring the case of the parameter.
abstract void	handleRequest(javax.servlet.http.HttpServletRequest aRequest, javax.servlet.http.HttpServletResponse aResponse) This method receives a request and handles it.
static boolean	isClassTraceOn() Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.
protected ILcdGXYLayerSubsetList	performSelectionAt(int aX, int aY, int aSensitivity, int aFeatureCount, Vector aGXYLayerList, ILcdGXYView aGXYView) Performs a selection on the given view and set of layers, and returns the selected objects as a ILcdGXYLayerSubsetList.
protected ILcdGXYLayerSubsetList	performSelectionInBounds(int aX, int aY, int aSelectionWidth, int aSelectionHeight, int aFeatureCount, Vector aGXYLayerList, ILcdGXYView aGXYView) Performs a selection on the given view and set of layers, and returns the selected objects as a ILcdGXYLayerSubsetList.
protected void	returnGXYView(TLcdGXYViewBufferedImage aGXYView) Releases a given TLcdGXYViewBufferedImage.
static void	setClassTraceOn(boolean aClassTraceOn) Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.
protected void	setGXYViewPoolSize(int aGXYViewPoolSize) Sets the size of the view pool.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.luciad.util.ILcdDisposable

close

Constructor Detail

ALcdWMSCommandDispatcher

public ALcdWMSCommandDispatcher()

Method Detail

handleRequest

public abstract void handleRequest(javax.servlet.http.HttpServletRequest aRequest,
                                   javax.servlet.http.HttpServletResponse aResponse)
                            throws javax.servlet.ServletException

This method receives a request and handles it.

Parameters:

aRequest - the received HttpServletRequest.

aResponse - the HttpServletResponse to send the result to.

Throws:

javax.servlet.ServletException - for servlet errors.

getParameterIgnoreCase

protected String getParameterIgnoreCase(String aParameterName,
                                        javax.servlet.http.HttpServletRequest aRequest)

Gets the value for a named parameter ignoring the case of the parameter.

Parameters:

aParameterName - parameter name .

aRequest - request object containing key-value pairs.

Returns:

the value for the given parameter name ignoring the case of the parameter name.

getGXYViewPoolSize

protected int getGXYViewPoolSize()

Returns the number of views within the pool.

Returns:

the number of views within the pool.

See Also:

setGXYViewPoolSize(int)

setGXYViewPoolSize

protected void setGXYViewPoolSize(int aGXYViewPoolSize)

Sets the size of the view pool. View pooling may speed up requests for data formats that have a significant amount of initialization work before they appear, such as for example ECDIS. It offers little to no advantage for imagery data as models are normally always pooled, see ILcdModelProvider.

Parameters:

aGXYViewPoolSize - the new amount of views. Set to 0 to disable view pooling.

See Also:

getGXYViewPoolSize()

getGXYView

protected TLcdGXYViewBufferedImage getGXYView()

Deprecated. This method is not used.

Gets a new TLcdGXYViewBufferedImage.

Returns:

a TLcdGXYViewBufferedImage.

returnGXYView

protected void returnGXYView(TLcdGXYViewBufferedImage aGXYView)

Releases a given TLcdGXYViewBufferedImage.

Parameters:

aGXYView - the TLcdGXYViewBufferedImage.

performSelectionAt

protected ILcdGXYLayerSubsetList performSelectionAt(int aX,
                                                    int aY,
                                                    int aSensitivity,
                                                    int aFeatureCount,
                                                    Vector aGXYLayerList,
                                                    ILcdGXYView aGXYView)

Performs a selection on the given view and set of layers, and returns the selected objects as a ILcdGXYLayerSubsetList. The selection is defined by a pixel position aX,aY, and a sensitivity in pixels. All objects that interact with a square selection area of size 2 * aSensitivity centered around the given pixel position are selected.

Parameters:

aX - the x value of the selection position on the view.

aY - the y value of the selection position on the view.

aSensitivity - the sensitivity to be considered for the selection position

aFeatureCount - the maximum number of objects (features) to be selected.

aGXYLayerList - a vector containing the ILcdGXYLayer objects being queried.

aGXYView - the map view for which the selection is requested.

Returns:

a list of the layers having actually selected objects.

performSelectionInBounds

protected ILcdGXYLayerSubsetList performSelectionInBounds(int aX,
                                                          int aY,
                                                          int aSelectionWidth,
                                                          int aSelectionHeight,
                                                          int aFeatureCount,
                                                          Vector aGXYLayerList,
                                                          ILcdGXYView aGXYView)

Performs a selection on the given view and set of layers, and returns the selected objects as a ILcdGXYLayerSubsetList. The selection is defined by pixel bounds, specified by its upper left location (aX,aY) and its width and height (aSelectionWidth,aSelectionHeight). By default, objects are only selected if their visual representation falls within these bounds.

Parameters:

aX - the x value of the upper left location of the selection rectangle.

aY - the y value of the upper left location of the selection rectangle.

aSelectionWidth - the width of the selection rectangle.

aSelectionHeight - the height of the selection rectangle.

aFeatureCount - the maximum number of objects (features) to be selected.

aGXYLayerList - vector containing the ILcdGXYLayer objects being queried.

aGXYView - the map view for which the selection is requested.

Returns:

a list of the layers having actually selected objects.

setClassTraceOn

public static void setClassTraceOn(boolean aClassTraceOn)

Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Enables tracing for all instances of this class. If the argument is true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.

Parameters:

aClassTraceOn - if true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.

isClassTraceOn

public static boolean isClassTraceOn()

Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Returns true if tracing is enabled for this class.

Returns:

true if tracing is enabled for this class, false otherwise.

dispose

public void dispose()

Description copied from interface: ILcdDisposable

Disposes of this object and allows it to release any system resources that it is holding.

The result of calling any other method (other than finalize) on this object subsequent to a call to this method is undefined.

Specified by:

dispose in interface ILcdDisposable