com.izforge.izpack.util

Class DefaultTargetPlatformFactory

java.lang.Object

com.izforge.izpack.util.DefaultTargetPlatformFactory

All Implemented Interfaces:

TargetPlatformFactory

public class DefaultTargetPlatformFactory
extends Object
implements TargetPlatformFactory

Factory for constructing platform specific implementation implementations of interfaces or classes.

It is configured using one or more TargetPlatformFactory.properties files, located in the class path under com/izforge/izpack/util/. A template is shown below.

 #
 # TargetPlatformFactory template.
 #
 # The format of each entry is as follows:
 #
 # <interface>[,name[,arch]] = <implementation>
 #
 # Where:
 # . interface      - is the fully qualified interface or class name
 # . name           - is the platform name corresponding to those defined in com.izforge.izpack.util.Platforms, as
 #                    lowercase
 # . arch           - is the platform architecture corresponding to com.izforge.izpack.util.Platform.Arch, as
 #                    lowercase
 # . implementation - is the implementation of the interface for the platform
 #
 # E.g.:
 # com.izforge.izpack.util.os.NativeWrapper,windows = com.izforge.izpack.util.os.WinWrapper
 # com.izforge.izpack.util.os.NativeWrapper,windows,x64 = com.izforge.izpack.util.os.Win64Wrapper
 # com.izforge.izpack.util.os.NativeWrapper,windows_xp = com.izforge.izpack.util.os.Windows7Wrapper
 # com.izforge.izpack.util.os.NativeWrapper,windows_7,x86 = com.izforge.izpack.util.os.Windows7x86Wrapper
 # com.izforge.izpack.util.os.NativeWrapper,windows_7,x64 = com.izforge.izpack.util.os.Windows7x64Wrapper
 # com.izforge.izpack.util.os.NativeWrapper,unix = com.izforge.izpack.util.os.GenericUnixWrapper
 # com.izforge.izpack.util.os.NativeWrapper,debian_linux = com.izforge.izpack.util.os.DebianLinuxWrapper
 # com.izforge.izpack.util.os.NativeWrapper,mac_osx = com.izforge.izpack.util.os.MacOSXWrapper
 # com.izforge.izpack.util.os.NativeWrapper = com.izforge.izpack.util.os.DefaultWrapper
 

Author:

Tim Anderson

See Also:

Platforms, Platform

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	DefaultTargetPlatformFactory.Implementations Manages implementations of a class/interface, for multiple platforms.
protected static class	DefaultTargetPlatformFactory.Parser Properties parser.

Constructor Summary

Constructors

Constructor and Description
DefaultTargetPlatformFactory(ObjectFactory factory, Platform platform, Platforms platforms) Constructs a DefaultTargetPlatformFactory, configured from TargetPlatformFactory.properties resources.

Method Summary

Modifier and Type	Method and Description
protected void	add(Properties properties, URL url) Adds the configuration from the specified URL.
<T> T	create(Class<T> clazz) Creates a platform specific implementation of a class, for the current platform.
<T> T	create(Class<T> type, Platform platform) Creates a platform specific instance of a class, for the specified platform.
protected DefaultTargetPlatformFactory.Parser	createParser(Platforms platforms, URL url) Creates a new parser.
protected <T> Class<T>	getImplementation(Class<T> type, Platform platform) Returns the implementation of a type for the specified platform.
protected DefaultTargetPlatformFactory.Implementations	getImplementations(Class clazz) Returns the implementations registered for the specified class.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultTargetPlatformFactory

public DefaultTargetPlatformFactory(ObjectFactory factory,
                                    Platform platform,
                                    Platforms platforms)

Constructs a DefaultTargetPlatformFactory, configured from TargetPlatformFactory.properties resources.

Parameters:

factory - the factory to delegate to

platform - the current platform

platforms - the platform factory

Method Detail

create

public <T> T create(Class<T> clazz)
             throws Exception

Creates a platform specific implementation of a class, for the current platform.

Specified by:

create in interface TargetPlatformFactory

Parameters:

clazz - the class to create a platform specific instance of

Returns:

the instance for the specified platform

Throws:

Exception - for any error

create

public <T> T create(Class<T> type,
                    Platform platform)
             throws Exception

Creates a platform specific instance of a class, for the specified platform.

Specified by:

create in interface TargetPlatformFactory

Parameters:

type - the type to create a platform specific instance of

platform - the platform

Returns:

the instance for the specified platform

Throws:

Exception - for any error

getImplementation

protected <T> Class<T> getImplementation(Class<T> type,
                                         Platform platform)
                                  throws ClassNotFoundException

Returns the implementation of a type for the specified platform.

Parameters:

type - the type

platform - the platform

Returns:

the implementation class of type for platform

Throws:

ClassNotFoundException - if a class is registered but cannot be found

IllegalStateException - if no class is registered, or the registered class does not implement nor extend type

add

protected void add(Properties properties,
                   URL url)

Adds the configuration from the specified URL.

Parameters:

properties - the configuration

url - the URL, for error reporting. May be null

createParser

protected DefaultTargetPlatformFactory.Parser createParser(Platforms platforms,
                                                           URL url)

Creates a new parser.

Parameters:

platforms - the platforms

url - the source URL

Returns:

a new parser

getImplementations

protected DefaultTargetPlatformFactory.Implementations getImplementations(Class clazz)

Returns the implementations registered for the specified class.

Parameters:

clazz - the class

Returns:

the corresponding implementations, or null if none are found