no.g9.service

Class G9Spring

java.lang.Object

no.g9.service.G9Spring

public class G9Spring
extends Object

The class is the common client-side proxy super class for Spring usage (as remote service).

Bean definitions are read from three types of xml-files.

1. Always present - these are the xml files that are part of the framework.
2. Optional with known name - these are xml files that have a pre-defined name, but might not be present, e.g. G9Service.xml
3. Additional files - these are xml files that have been supplied runtime.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	G9Spring.ApplicationContextReference Reference class used to allow for changing the ApplicationContext by installing a reimplementation of this class.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	G9Spring() Prohibit instantiation

Method Summary

Modifier and Type	Method and Description
static void	addAdditionalBeanDefinition(String fileName) Deprecated. include additional xml files in the G9Service.xml file
static org.springframework.context.ApplicationContext	getApplicationContext() Get the spring application context.
static <T> T	getBean(Class<T> serviceInterface, String beanID) Gets the specified spring bean.
static <T> T	getBean(String beanID) Gets the specified spring bean.
static String[]	getBeanDefinitions()
static String[]	getDefaultBeanDefinitions()
static String[]	getOptionalBeanDefinitions()
static void	loadApplicationContext() Load the spring application context if needed.

Methods inherited from class java.lang.Object

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

Constructor Detail

G9Spring

protected G9Spring()

Prohibit instantiation

Method Detail

getDefaultBeanDefinitions

public static String[] getDefaultBeanDefinitions()

Returns:

array of default bean definitions.

getOptionalBeanDefinitions

public static String[] getOptionalBeanDefinitions()

Returns:

array of optional bean definitions.

addAdditionalBeanDefinition

@Deprecated
public static void addAdditionalBeanDefinition(String fileName)

Deprecated. include additional xml files in the G9Service.xml file

Add an additional file name as a spring bean definitions xml file. The file must be on the class path in order for spring to find it. The file must be added before the spring application context is loaded (which happens the first time a bean is accessed), in other words -- do this at the earliest possible time.

Parameters:

fileName - the name of the xml file.

getBean

public static <T> T getBean(Class<T> serviceInterface,
                            String beanID)

Gets the specified spring bean.

Type Parameters:

T - the interface type of the bean

Parameters:

serviceInterface - the interface class that the bean implements

beanID - the bean id used by Spring to identify the bean

Returns:

the Spring bean

getBean

public static <T> T getBean(String beanID)

Gets the specified spring bean.

Type Parameters:

T - the type of the bean.

Parameters:

beanID - the bean id used by Spring to identify the bean.

Returns:

the Spring bean.

getApplicationContext

public static org.springframework.context.ApplicationContext getApplicationContext()

Get the spring application context.

Returns:

the applicationContext set up with the bean definitions.

loadApplicationContext

public static void loadApplicationContext()

Load the spring application context if needed. This is only performed the first time, viz. when the application context has not been previously loaded.

getBeanDefinitions

public static String[] getBeanDefinitions()

Returns:

an array of Spring resource files to be used for the application context