Java Doc for MIFFile.java in  » GIS » GeoTools-2.4.1 » org » geotools » data » mif » Java Source Code / Java DocumentationJava Source Code and Java Documentation

MIFFile class allows sequential reading and writing of Features in MapInfo MIF/MID text file format with a FeatureReader and FeatureWriter.

This class has been developed starting from MapInfoDataSource.

Open issues:

• CoordSys clause parsing is still not supported

This constructor opens an existing MIF/MID file, and creates the corresponding schema from the file header

Allowed parameters in params Map:

• "namespace" = URI of the namespace prefix for FeatureTypes
• PARAM_GEOMFACTORY = GeometryFactory object to be used for creating geometries; alternatively, use PARAM_SRID;
• PARAM_SRID = SRID to be used for creating geometries;
• PARAM_FIELDCASE = field names tranformation: "upper" to uppercase | "lower" to lowercase | "" none;
• PARAM_GEOMNAME = <String>, name of the geometry field (defaults to "the_geom");
• PARAM_GEOMTYPE = geometry type handling: "untyped" uses Geometry class | "typed" force geometry to the type of the first valid geometry found in file | "multi" like typed, but forces LineString to MultilineString and Polygon to MultiPolygon; | "Point" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon" | "Text" forces Geometry to Point and creates a MIF_TEXT String field in the schema

Header clauses values can also be set in the params Map, but they might be overridden by values read from MIF header.

This constructor creates a a new MIF/MID file given schema and path.

Opens the MIF file for input and returns a FeatureReader for accessing the features.

TODO Concurrent file access is still not handled.

This constructor opens an existing MIF/MID file, and creates the corresponding schema from the file header

Allowed parameters in params Map:

• "namespace" = URI of the namespace prefix for FeatureTypes
• PARAM_GEOMFACTORY = GeometryFactory object to be used for creating geometries; alternatively, use PARAM_SRID;
• PARAM_SRID = SRID to be used for creating geometries;
• PARAM_FIELDCASE = field names tranformation: "upper" to uppercase | "lower" to lowercase | "" none;
• PARAM_GEOMNAME = <String>, name of the geometry field (defaults to "the_geom");
• PARAM_GEOMTYPE = geometry type handling: "untyped" uses Geometry class | "typed" force geometry to the type of the first valid geometry found in file | "multi" like typed, but forces LineString to MultilineString and Polygon to MultiPolygon; | "Point" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon" | "Text" forces Geometry to Point and creates a MIF_TEXT String field in the schema

Header clauses values can also be set in the params Map, but they might be overridden by values read from MIF header.

Basic usage:

 HashMap params = new HashMap();
 // params.put(MIFFile.PARAM_GEOMFACTORY, new GeometryFactory(new PrecisionModel(PrecisionModel.FLOATING_SINGLE), SRID));
 params.put(MIFFile.PARAM_SRID, new Integer(SRID));
 params.put(MIFFile.PARAM_FIELDCASE, "upper");
 params.put(MIFFile.PARAM_GEOMNAME, "GEOM");
 params.put(MIFFile.PARAM_GEOMTYPE, "typed");
 MIFFile mf = new MIFFile("c:/some_path/file.mif",params);
 FeatureType ft = mf.getSchema();
 FeatureReader fr = mf.getFeatureReader();	
 while (fr.hasNext()) {
 Feature in = fr.next();
 doSomethingWithFeature(in);
 }
 fr.close(); // closes file resources
 

This constructor creates a a new MIF/MID file given schema and path. If a .mif/.mid file pair already exists, it will be overwritten.

Basic usage:

 HashMap params = new HashMap();
 params.put(MIFFile.MIFDataStore.HCLAUSE_COORDSYS, "Nonearth \"m\"");
 MIFFile mf = new MIFFile("c:/some_path/", ft, params);
 FeatureWriter fw = mf.getFeatureWriter();
 while(...) {
 Feature f = fw.next();
 f.setAttribute(...,...);
 fw.write();
 }
 fw.close();
 

Opens the MIF file for input and returns a FeatureReader for accessing the features.

TODO Concurrent file access is still not handled. MUST LOCK FILE and return an error if another FeatureReader is open - Handle concurrent access with synchronized(mif) / or Filesystem locking is enough?