org.geotools.data.shapefile.shp
Interface ShapeHandler

All Known Implementing Classes:
MultiLineHandler, MultiLineHandler, MultiPointHandler, MultiPointHandler, PointHandler, PointHandler, PolygonHandler, PolygonHandler

public interface ShapeHandler

A ShapeHandler defines what is needed to construct and persist geometries based upon the shapefile specification.

Version:
Author:
aaime, Ian Schneider

Method Summary
 int getLength(java.lang.Object geometry)
          Get the length of the given geometry Object in bytes not 16-bit words.
 ShapeType getShapeType()
          Get the ShapeType of this handler.
 java.lang.Object read(java.nio.ByteBuffer buffer, ShapeType type)
          Read a geometry from the ByteBuffer.
 void write(java.nio.ByteBuffer buffer, java.lang.Object geometry)
          Write the geometry into the ByteBuffer.
 

Method Detail

getShapeType

public ShapeType getShapeType()
Get the ShapeType of this handler.

Returns:
The ShapeType.

read

public java.lang.Object read(java.nio.ByteBuffer buffer,
                             ShapeType type)
Read a geometry from the ByteBuffer. The buffer's position, byteOrder, and limit are set to that which is needed. The record has been read as well as the shape type integer. The handler need not worry about reading unused information as the ShapefileReader will correctly adjust the buffer position after this call.

Parameters:
buffer - The ByteBuffer to read from.
Returns:
A geometry object.

write

public void write(java.nio.ByteBuffer buffer,
                  java.lang.Object geometry)
Write the geometry into the ByteBuffer. The position, byteOrder, and limit are all set. The handler is not responsible for writing the record or shape type integer.

Parameters:
buffer - The ByteBuffer to write to.
geometry - The geometry to write.

getLength

public int getLength(java.lang.Object geometry)
Get the length of the given geometry Object in bytes not 16-bit words. This is easier to keep track of, since the ByteBuffer deals with bytes. Do not include the 8 bytes of record.

Parameters:
geometry - The geometry to analyze.
Returns:
The number of bytes the shape will take up.


Copyright © GeoTools. All Rights Reserved.