Package org.meteoinfo.jts.io
Class WKBReader
- java.lang.Object
-
- org.meteoinfo.jts.io.WKBReader
-
public class WKBReader extends java.lang.ObjectReads aGeometryfrom a byte stream in Well-Known Binary format. Supports use of anInStream, which allows easy use with arbitrary byte stream sources.This class reads the format describe in
WKBWriter. It also partially handles the Extended WKB format used by PostGIS, by parsing and storing SRID values. The reader repairs structurally-invalid input (specifically, LineStrings and LinearRings which contain too few points have vertices added, and non-closed rings are closed).This class is designed to support reuse of a single instance to read multiple geometries. This class is not thread-safe; each thread should create its own instance.
- See Also:
for a formal format specification
-
-
Constructor Summary
Constructors Constructor Description WKBReader()WKBReader(GeometryFactory geometryFactory)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static byte[]hexToBytes(java.lang.String hex)Converts a hexadecimal string to a byte array.Geometryread(byte[] bytes)Reads a singleGeometryin WKB format from a byte array.Geometryread(InStream is)
-
-
-
Constructor Detail
-
WKBReader
public WKBReader()
-
WKBReader
public WKBReader(GeometryFactory geometryFactory)
-
-
Method Detail
-
hexToBytes
public static byte[] hexToBytes(java.lang.String hex)
Converts a hexadecimal string to a byte array. The hexadecimal digit symbols are case-insensitive.- Parameters:
hex- a string containing hex digits- Returns:
- an array of bytes with the value of the hex string
-
read
public Geometry read(byte[] bytes) throws ParseException
Reads a singleGeometryin WKB format from a byte array.- Parameters:
bytes- the byte array to read from- Returns:
- the geometry read
- Throws:
ParseException- if the WKB is ill-formed
-
read
public Geometry read(InStream is) throws java.io.IOException, ParseException
- Parameters:
is- the stream to read from- Returns:
- the Geometry read
- Throws:
java.io.IOException- if the underlying stream creates an errorParseException- if the WKB is ill-formed
-
-