Provide custom mappings to and from native types. The default lookup checks classes corresponding to converters in the order added; if the class to be converted is an instance of the converter's registered class, the converter will be used.

Derived classes should install additional converters using addToNativeConverter and/or addFromNativeConverter in the default constructor. Classes for primitive types will automatically register for the corresponding Object type and vice versa (i.e. you don't have to register both int.class and Integer.class). If you want different mapping behavior than the default, simply override getToNativeConverter and getFromNativeConverter.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	DefaultTypeMapper.Entry

Field Summary

Modifier and Type	Field and Description
private List<DefaultTypeMapper.Entry>	fromNativeConverters
private List<DefaultTypeMapper.Entry>	toNativeConverters

Constructor Summary

Access	Constructor and Description
public	DefaultTypeMapper()

Method Summary

Modifier and Type	Method and Description
public void	addFromNativeConverter(Class<?> Java class for the Java representation of a native type. cls, FromNativeConverter `FromNativeConverter` to transform a native-compatible type into its Java equivalent. converter) Add a `FromNativeConverter` to convert a native result type into the given Java type.
public void	addToNativeConverter(Class<?> Java class requiring conversion cls, ToNativeConverter `ToNativeConverter` to transform an object of the given Java class into its native-compatible form. converter) Add a `ToNativeConverter` to define the conversion into a native type from arguments of the given Java type.
public void	addTypeConverter(Class<?> Java class representation for a native type cls, TypeConverter `TypeConverter` to translate between native and Java types. converter) Add a `TypeConverter` to provide bidirectional mapping between a native and Java type.
private Class<?>	getAltClass(Class<?> cls)
public FromNativeConverter	getFromNativeConverter(Class<?> Java class representation of the native type. javaType) Implements com.sun.jna.TypeMapper.getFromNativeConverter. Return the `FromNativeConverter` appropriate for the given Java class.
public ToNativeConverter	getToNativeConverter(Class<?> Java class representation of the native type. javaType) Implements com.sun.jna.TypeMapper.getToNativeConverter. Return the `ToNativeConverter` appropriate for the given Java class.
private Object	lookupConverter(Class<?> javaClass, Collection<? extends DefaultTypeMapper.Entry> converters)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

fromNativeConverters	back to summary
private List<DefaultTypeMapper.Entry> fromNativeConverters

toNativeConverters	back to summary
private List<DefaultTypeMapper.Entry> toNativeConverters

Constructor Detail

DefaultTypeMapper	back to summary
public DefaultTypeMapper()

Method Detail

addFromNativeConverter back to summary

addFromNativeConverter	back to summary
public void addFromNativeConverter(Class<?> cls, FromNativeConverter converter) Add a `FromNativeConverter` to convert a native result type into the given Java type. Converters are checked for in the order added. Parameters cls:Class<?> Java class for the Java representation of a native type. converter:FromNativeConverter `FromNativeConverter` to transform a native-compatible type into its Java equivalent.

public void addFromNativeConverter(Class<?> cls, FromNativeConverter converter)

Add a FromNativeConverter to convert a native result type into the given Java type. Converters are checked for in the order added.

Parameters

cls:Class<?>: Java class for the Java representation of a native type.
converter:FromNativeConverter: FromNativeConverter to transform a native-compatible type into its Java equivalent.

addToNativeConverter back to summary

addToNativeConverter	back to summary
public void addToNativeConverter(Class<?> cls, ToNativeConverter converter) Add a `ToNativeConverter` to define the conversion into a native type from arguments of the given Java type. Converters are checked for in the order added. Parameters cls:Class<?> Java class requiring conversion converter:ToNativeConverter `ToNativeConverter` to transform an object of the given Java class into its native-compatible form.

public void addToNativeConverter(Class<?> cls, ToNativeConverter converter)

Add a ToNativeConverter to define the conversion into a native type from arguments of the given Java type. Converters are checked for in the order added.

Parameters

cls:Class<?>: Java class requiring conversion
converter:ToNativeConverter: ToNativeConverter to transform an object of the given Java class into its native-compatible form.

addTypeConverter back to summary

addTypeConverter	back to summary
public void addTypeConverter(Class<?> cls, TypeConverter converter) Add a `TypeConverter` to provide bidirectional mapping between a native and Java type. Parameters cls:Class<?> Java class representation for a native type converter:TypeConverter `TypeConverter` to translate between native and Java types.

public void addTypeConverter(Class<?> cls, TypeConverter converter)

Add a TypeConverter to provide bidirectional mapping between a native and Java type.

Parameters

cls:Class<?>: Java class representation for a native type
converter:TypeConverter: TypeConverter to translate between native and Java types.

getAltClass	back to summary
private Class<?> getAltClass(Class<?> cls)

getFromNativeConverter back to summary

getFromNativeConverter	back to summary
public FromNativeConverter getFromNativeConverter(Class<?> javaType) Implements com.sun.jna.TypeMapper.getFromNativeConverter. Doc from com.sun.jna.TypeMapper.getFromNativeConverter. Return the `FromNativeConverter` appropriate for the given Java class. Parameters javaType:Class<?> Java class representation of the native type. Returns:FromNativeConverter Converter from the native-compatible type. Annotations @Override

public FromNativeConverter getFromNativeConverter(Class<?> javaType)

Implements com.sun.jna.TypeMapper.getFromNativeConverter.

Doc from com.sun.jna.TypeMapper.getFromNativeConverter.

Return the FromNativeConverter appropriate for the given Java class.

Parameters

javaType:Class<?>: Java class representation of the native type.

Returns:FromNativeConverter

Converter from the native-compatible type.

Annotations

@Override

getToNativeConverter back to summary

getToNativeConverter	back to summary
public ToNativeConverter getToNativeConverter(Class<?> javaType) Implements com.sun.jna.TypeMapper.getToNativeConverter. Doc from com.sun.jna.TypeMapper.getToNativeConverter. Return the `ToNativeConverter` appropriate for the given Java class. Parameters javaType:Class<?> Java class representation of the native type. Returns:ToNativeConverter Converter to the native-compatible type. Annotations @Override

public ToNativeConverter getToNativeConverter(Class<?> javaType)

Implements com.sun.jna.TypeMapper.getToNativeConverter.

Doc from com.sun.jna.TypeMapper.getToNativeConverter.

Return the ToNativeConverter appropriate for the given Java class.

Parameters

javaType:Class<?>: Java class representation of the native type.

Returns:ToNativeConverter

Converter to the native-compatible type.

Annotations

@Override

lookupConverter	back to summary
private Object lookupConverter(Class<?> javaClass, Collection<? extends DefaultTypeMapper.Entry> converters)

com.sun.jna back to summary

private Class DefaultTypeMapper.Entry

Class Inheritance

extends Object

java.lang.Object
com.sun.jna.DefaultTypeMapper.Entry

Field Summary

Modifier and Type	Field and Description
public Object	converter
public Class<?>	type

Constructor Summary

Access	Constructor and Description
public	Entry(Class<?> type, Object converter)

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

converter	back to summary
public Object converter

type	back to summary
public Class<?> type

Constructor Detail

Entry	back to summary
public Entry(Class<?> type, Object converter)

public Class DefaultTypeMapper

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class DefaultTypeMapper.Entry

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail