org.apache.commons.geometry.examples.io.threed

Class ModelIOHandlerRegistry

java.lang.Object

org.apache.commons.geometry.examples.io.threed.ModelIOHandlerRegistry

All Implemented Interfaces:

ModelIOHandler

Direct Known Subclasses:

DefaultModelIOHandlerRegistry

public class ModelIOHandlerRegistry
extends Object
implements ModelIOHandler

Object that holds an internal registry ModelIOHandler and delegates read/write operations to them as determined by their supported model types.

Instances of this class are thread-safe as long as all registered handlers are also thread-safe.

Constructor Summary

Constructors

Constructor and Description
ModelIOHandlerRegistry()

Method Summary

Modifier and Type	Method and Description
ModelIOHandler	getHandlerForType(String type) Get the ModelIOHandler for the given type or null if no handler is found.
List<ModelIOHandler>	getHandlers() Get the list of registered ModelIOHandlers.
boolean	handlesType(String type) Return true if this instance handles 3D model files of the given type.
BoundarySource3D	read(File in, DoublePrecisionContext precision) Read a 3D model from the given file, using the file extension as the model type.
BoundarySource3D	read(String type, File in, DoublePrecisionContext precision) Read a 3D model represented as a BoundarySource3D from the given file.
BoundarySource3D	read(String type, InputStream in, DoublePrecisionContext precision) Read a 3D model represented as a BoundarySource3D from the given input stream.
void	setHandlers(List<ModelIOHandler> newHandlers) Set the list of registered ModelIOHandlers.
void	write(BoundarySource3D model, File out) Write the model to the file.
void	write(BoundarySource3D model, String type, File out) Write the model to the file using the specified file type.
void	write(BoundarySource3D model, String type, OutputStream out) Write the model to the given output stream, using the specified model type.

Methods inherited from class java.lang.Object

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

Constructor Detail

ModelIOHandlerRegistry

public ModelIOHandlerRegistry()

Method Detail

getHandlerForType

public ModelIOHandler getHandlerForType(String type)

Get the ModelIOHandler for the given type or null if no handler is found.

Parameters:

type - model type to retrieve the handler for

Returns:

the handler for the given type or null if no handler is found

getHandlers

public List<ModelIOHandler> getHandlers()

Get the list of registered ModelIOHandlers.

Returns:

the registered ModelIOHandlers

setHandlers

public void setHandlers(List<ModelIOHandler> newHandlers)

Set the list of registered ModelIOHandlers.

Parameters:

newHandlers - the new list of ModelIOHandlers.

handlesType

public boolean handlesType(String type)

Return true if this instance handles 3D model files of the given type.

Specified by:

handlesType in interface ModelIOHandler

Parameters:

type - type 3D model type, indicated by file extension

Returns:

true if this instance can handle the 3D model file type

read

public BoundarySource3D read(File in,
                             DoublePrecisionContext precision)

Read a 3D model from the given file, using the file extension as the model type.

Parameters:

in - file to read from

precision - precision context to use in model construction

Returns:

a 3D model represented as a boundary source

Throws:

UncheckedIOException - if an IO operation fails

IllegalArgumentException - if the file does not have a file extension or the file extension does not indicate a supported model type

read

public BoundarySource3D read(String type,
                             File in,
                             DoublePrecisionContext precision)

Read a 3D model represented as a BoundarySource3D from the given file.

Specified by:

read in interface ModelIOHandler

Parameters:

type - the model file type

in - file to read

precision - precision context to use in model construction

Returns:

a 3D model represented as a boundary source

read

public BoundarySource3D read(String type,
                             InputStream in,
                             DoublePrecisionContext precision)

Read a 3D model represented as a BoundarySource3D from the given input stream. The input stream is closed before method return.

Specified by:

read in interface ModelIOHandler

Parameters:

type - the model input type

in - input stream

precision - precision context to use in model construction

Returns:

a 3D model represented as a boundary source

write

public void write(BoundarySource3D model,
                  File out)

Write the model to the file. The file type is determined by the file extension of the target file.

Parameters:

model - model to write

out - output file

Throws:

UncheckedIOException - if an IO operation fails

IllegalArgumentException - if the file does not have a file extension or the file extension does not indicate a supported model type

write

public void write(BoundarySource3D model,
                  String type,
                  File out)

Write the model to the file using the specified file type.

Specified by:

write in interface ModelIOHandler

Parameters:

model - model to write

type - the model file type

out - output file

write

public void write(BoundarySource3D model,
                  String type,
                  OutputStream out)

Write the model to the given output stream, using the specified model type. The output stream is closed before method return.

Specified by:

write in interface ModelIOHandler

Parameters:

model - model to write

type - the model file type

out - output stream