9 |
--------------------------------------------------------------------------------
/sandbox/com/interface21/web/servlet/mvc/AbstractListFormController.java:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/cbeams/spring-framework-i21/ed27de6d3e2246b2e6d7538e1fe7f7226d11ec3d/sandbox/com/interface21/web/servlet/mvc/AbstractListFormController.java
--------------------------------------------------------------------------------
/sandbox/com/interface21/web/servlet/mvc/AbstractParamListFormController.java:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/cbeams/spring-framework-i21/ed27de6d3e2246b2e6d7538e1fe7f7226d11ec3d/sandbox/com/interface21/web/servlet/mvc/AbstractParamListFormController.java
--------------------------------------------------------------------------------
/src/com/interface21/aop/attributes/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Package containing AOP support for metadata attributes.
5 | Not fully implemented yet.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/framework/AbstractMethodPointcut.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.aop.framework;
7 |
8 | import org.aopalliance.intercept.MethodInterceptor;
9 |
10 | /**
11 | * Abstract convenience superclass for implementations of
12 | * DynamicMethodPointcut or StaticMethodPointcut. Handles
13 | * interceptor.
14 | * @author Rod Johnson
15 | * @since July 22, 2003
16 | * @version $Id$
17 | */
18 | public abstract class AbstractMethodPointcut implements MethodPointcut {
19 |
20 | private MethodInterceptor interceptor;
21 |
22 | protected AbstractMethodPointcut() {
23 | }
24 |
25 | protected AbstractMethodPointcut(MethodInterceptor interceptor) {
26 | this.interceptor = interceptor;
27 | }
28 | /**
29 | * @see com.interface21.aop.framework.MethodPointcut#getInterceptor()
30 | */
31 | public MethodInterceptor getInterceptor() {
32 | return this.interceptor;
33 | }
34 |
35 | public void setInterceptor(MethodInterceptor interceptor) {
36 | this.interceptor = interceptor;
37 | }
38 |
39 | }
40 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/framework/AlwaysInvoked.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.aop.framework;
7 |
8 | import java.lang.reflect.Method;
9 |
10 | import org.aopalliance.intercept.AttributeRegistry;
11 | import org.aopalliance.intercept.MethodInterceptor;
12 |
13 | /**
14 | * MethodPointcut implementation wrapping an
15 | * Interceptor that should always run.
16 | * @author Rod Johnson
17 | * @since 04-Apr-2003
18 | * @version $Id$
19 | */
20 | public class AlwaysInvoked extends AbstractMethodPointcut implements StaticMethodPointcut {
21 |
22 | public AlwaysInvoked(MethodInterceptor interceptor) {
23 | super(interceptor);
24 | }
25 |
26 | /**
27 | * @see com.interface21.aop.framework.StaticMethodPointcut#applies(java.lang.reflect.Method, AttributeRegistry)
28 | */
29 | public boolean applies(Method m, AttributeRegistry ar) {
30 | return true;
31 | }
32 |
33 | }
34 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/framework/AopConfigException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.aop.framework;
7 |
8 | import com.interface21.core.NestedRuntimeException;
9 |
10 | /**
11 | *
12 | * @author Rod Johnson
13 | * @since 13-Mar-2003
14 | * @version $Revision$
15 | */
16 | public class AopConfigException extends NestedRuntimeException {
17 |
18 | /**
19 | * @param mesg
20 | */
21 | public AopConfigException(String mesg) {
22 | super(mesg);
23 | }
24 |
25 |
26 | }
27 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/framework/AopUtils.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.aop.framework;
3 |
4 | import java.util.HashSet;
5 | import java.util.Set;
6 |
7 | /**
8 | * Utility methods used by the AOP framework.
9 | * @author Rod Johnson
10 | * @version $Id$
11 | */
12 | public class AopUtils {
13 |
14 | /**
15 | * Get all implemented interfaces, even those implemented by superclasses.
16 | * @param clazz
17 | * @return Set
18 | */
19 | public static Set findAllImplementedInterfaces(Class clazz) {
20 | Set s = new HashSet();
21 | Class[] interfaces = clazz.getInterfaces();
22 | for (int i = 0; i < interfaces.length; i++) {
23 | s.add(interfaces[i]);
24 | }
25 | Class superclass = clazz.getSuperclass();
26 | if (superclass != null) {
27 | s.addAll(findAllImplementedInterfaces(superclass));
28 | }
29 | return s;
30 | }
31 |
32 | }
33 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/framework/IntroductionInterceptor.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.aop.framework;
7 |
8 | import org.aopalliance.intercept.MethodInterceptor;
9 |
10 | /**
11 | * Subinterface of MethodInterceptor that allows additional
12 | * interfaces to be implemented by the interceptor, and available
13 | * via a proxy using that interceptor. This is commonly
14 | * referred to as introduction.
15 | * DefaultProxyConfig and subclasses will automatically recognise
16 | * introduction interceptors and expose any interfaces they
17 | * introduce.
18 | * @see DefaultProxyConfig
19 | * @author Rod Johnson
20 | * @version $Id$
21 | */
22 | public interface IntroductionInterceptor extends MethodInterceptor {
23 |
24 | /**
25 | * Return the introduced interfaces added by this object
26 | * @return Class[]
27 | */
28 | Class[] getIntroducedInterfaces();
29 |
30 | }
31 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/framework/MethodPointcut.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.aop.framework;
7 |
8 | import org.aopalliance.intercept.MethodInterceptor;
9 |
10 | /**
11 | * Interface to be implemented by objects that can cause
12 | * conditional invocation of an Interceptor depending on
13 | * the method, arguments and attributes passed.
14 | * @author Rod Johnson
15 | * @since 03-Apr-2003
16 | * @version $Id$
17 | */
18 | public interface MethodPointcut {
19 |
20 | /**
21 | * Return the interceptor to run conditionally
22 | * @return MethodInterceptor
23 | */
24 | MethodInterceptor getInterceptor();
25 |
26 | /**
27 | * Arbitrary int value. Depends on other values.
28 | * Higher values cause interceptors to be invoked earlier
29 | * in the invocation chain.
30 | * @return int
31 | */
32 | //int getPrecedence();
33 | }
34 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/framework/ProxyInterceptor.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.aop.framework;
7 |
8 | import org.aopalliance.intercept.Interceptor;
9 |
10 | /**
11 | * Interface to be implemented by interceptors that have
12 | * a proxy target.
13 | * @author Rod Johnson
14 | * @since 14-Mar-2003
15 | * @version $Revision$
16 | */
17 | public interface ProxyInterceptor extends Interceptor {
18 |
19 | Object getTarget();
20 |
21 | }
22 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/framework/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Package containing Spring's basic AOP infrastructure,
5 | compliant with the AOP Alliance interfaces.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/interceptor/AbstractQaInterceptor.java:
--------------------------------------------------------------------------------
1 | package com.interface21.aop.interceptor;
2 |
3 | import org.aopalliance.intercept.MethodInterceptor;
4 | import org.aopalliance.intercept.MethodInvocation;
5 |
6 | public abstract class AbstractQaInterceptor implements MethodInterceptor {
7 |
8 | /**
9 | * @see org.aopalliance.intercept.MethodInterceptor#invoke(MethodInvocation)
10 | */
11 | public Object invokeInternal(MethodInvocation invocation) throws Throwable {
12 | Object result = invocation.proceed();
13 | checkInvariants(invocation.getThis());
14 | return result;
15 | }
16 |
17 | protected abstract void checkInvariants(Object target);
18 |
19 | }
20 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/interceptor/ClassLoaderAnalyzerInterceptor.java:
--------------------------------------------------------------------------------
1 | package com.interface21.aop.interceptor;
2 |
3 | import org.aopalliance.intercept.MethodInterceptor;
4 | import org.aopalliance.intercept.MethodInvocation;
5 | import org.apache.commons.logging.Log;
6 | import org.apache.commons.logging.LogFactory;
7 |
8 | import com.interface21.util.ClassLoaderUtils;
9 |
10 | /**
11 | * Trivial classloader analyzer interceptor.
12 | * @version $Id$
13 | * @author Rod Johnson
14 | * @author Dmitriy Kopylenko
15 | */
16 | public class ClassLoaderAnalyzerInterceptor implements MethodInterceptor {
17 |
18 | protected final Log logger = LogFactory.getLog(getClass());
19 |
20 | public Object invoke(MethodInvocation pInvocation) throws Throwable {
21 | logger.debug("Begin class loader analysis");
22 |
23 | logger.info(ClassLoaderUtils.showClassLoaderHierarchy(
24 | pInvocation.getThis(),
25 | pInvocation.getThis().getClass().getName(),
26 | "\n",
27 | "-"));
28 | Object rval = pInvocation.proceed();
29 |
30 | logger.debug("End class loader analysis");
31 | return rval;
32 | }
33 |
34 | }
35 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/interceptor/DebugInterceptor.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.aop.interceptor;
3 |
4 | import org.aopalliance.intercept.MethodInterceptor;
5 | import org.aopalliance.intercept.MethodInvocation;
6 |
7 | /**
8 | * Trivial interceptor that can be introduced in a chain to display it.
9 | *
10 | * (c) Rod Johnson, 2003
11 | * @author Rod Johnson
12 | */
13 | public class DebugInterceptor implements MethodInterceptor {
14 |
15 | // TODO learning interceptor?
16 | // AI? learns usage pattern?
17 | // code metrics
18 | // param values, etc?
19 |
20 | private int count;
21 |
22 | /**
23 | * @see org.aopalliance.intercept.MethodInterceptor#invoke(MethodInvocation)
24 | */
25 | public Object invoke(MethodInvocation invocation) throws Throwable {
26 | ++count;
27 | System.out.println("Debug interceptor: count=" + count +
28 | " invocation=[" + invocation + "]");
29 | Object rval = invocation.proceed();
30 | System.out.println("Debug interceptor: next returned");
31 | return rval;
32 | }
33 |
34 | public int getCount() {
35 | return this.count;
36 | }
37 |
38 | }
39 |
--------------------------------------------------------------------------------
/src/com/interface21/aop/interceptor/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Provides miscellaneous interceptor implementations.
5 | More specific interceptors can be found in the respective
6 | functionality packages, like "transaction" and "orm".
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/BeansException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans;
2 |
3 | import com.interface21.core.NestedRuntimeException;
4 |
5 | /**
6 | * Abstract superclass for all exceptions thrown in the beans package
7 | * and subpackages. Note that this is a runtime (unchecked) exception.
8 | * Beans exceptions are usually fatal; there is no reason for them to be
9 | * checked.
10 | * @author Rod Johnson
11 | */
12 | public abstract class BeansException extends NestedRuntimeException {
13 |
14 | /**
15 | * Constructs an BeansException with the specified message
16 | * and root cause.
17 | * @param msg the detail message.
18 | * @param t the root cause
19 | */
20 | public BeansException(String msg, Throwable t) {
21 | super(msg, t);
22 | }
23 |
24 | /**
25 | * Constructs an BeansException with the specified message
26 | * and no root cause.
27 | * @param msg the detail message.
28 | */
29 | public BeansException(String msg) {
30 | super(msg);
31 | }
32 |
33 | }
34 |
35 |
36 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/FatalBeanException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans;
2 |
3 | /**
4 | * Thrown on an unrecoverable problem encountered in the
5 | * beans packages or sub-packages: e.g. bad class or field.
6 | * @author Rod Johnson
7 | * @version $Revision$
8 | */
9 | public class FatalBeanException extends BeansException {
10 |
11 | /**
12 | * Constructs a FatalBeanException
13 | * with the specified message.
14 | * @param msg the detail message.
15 | */
16 | public FatalBeanException(String msg) {
17 | super(msg);
18 | }
19 |
20 | /**
21 | * Constructs a FatalBeanException
22 | * with the specified message and root cause.
23 | * @param msg the detail message.
24 | * @param t root cause
25 | */
26 | public FatalBeanException(String msg, Throwable t) {
27 | super(msg, t);
28 | }
29 | }
30 |
31 |
32 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/NotWritablePropertyException.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.beans;
3 |
4 | /**
5 | * Exception thrown on an attempt to set the value of
6 | * a property that isn't writable, because there's no
7 | * setter method.
8 | * @author Rod Johnson
9 | */
10 | public class NotWritablePropertyException extends BeansException {
11 |
12 | /**
13 | * Creates new NotWritablePropertyException without detail message.
14 | */
15 | public NotWritablePropertyException(String propertyName, Class beanClass) {
16 | super("Property [" + propertyName + "] is not writable in bean class [" + beanClass.getName() + "]");
17 | }
18 | }
19 |
20 |
21 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/NullValueInNestedPathException.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.beans;
3 |
4 | /**
5 | * Exception thrown when navigation of a valid nested property
6 | * path encounters a null pointer exception. For example,
7 | * navigating spouse.age fails because the spouse property of the
8 | * target object has a null value.
9 | * @author Rod Johnson
10 | */
11 | public class NullValueInNestedPathException extends FatalBeanException {
12 |
13 | private String property;
14 |
15 | private Class clazz;
16 |
17 | /**
18 | * Constructor for NullValueInNestedPathException.
19 | * @param clazz
20 | * @param propertyName
21 | */
22 | public NullValueInNestedPathException(Class clazz, String propertyName) {
23 | super("Value of nested property '" + propertyName + "' is null in " + clazz, null);
24 | this.property = propertyName;
25 | this.clazz = clazz;
26 | }
27 |
28 | /**
29 | * @return the name of the offending property
30 | */
31 | public String getPropertyName() {
32 | return property;
33 | }
34 |
35 | public Class getBeanClass() {
36 | return clazz;
37 | }
38 |
39 | }
40 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/PropertyAccessException.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.beans;
3 |
4 | import java.beans.PropertyChangeEvent;
5 |
6 | /**
7 | * Superclass for exceptions related to a property access,
8 | * such as type mismatch or invocation target exception.
9 | * @author Rod Johnson
10 | * @version $Revision$
11 | */
12 | public abstract class PropertyAccessException extends BeansException {
13 |
14 | private PropertyChangeEvent propertyChangeEvent;
15 |
16 | public PropertyAccessException(String mesg, PropertyChangeEvent propertyChangeEvent, Throwable t) {
17 | super(mesg, t);
18 | this.propertyChangeEvent = propertyChangeEvent;
19 | }
20 |
21 | /**
22 | * @return the PropertyChangeEvent that resulted in the problem
23 | */
24 | public PropertyChangeEvent getPropertyChangeEvent() {
25 | return propertyChangeEvent;
26 | }
27 |
28 | }
29 |
30 |
31 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/SortDefinition.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans;
2 |
3 | /**
4 | * Definition for sorting bean instances by a property.
5 | * @author Juergen Hoeller
6 | * @since 26.05.2003
7 | */
8 | public interface SortDefinition {
9 |
10 | /**
11 | * Return the name of the property to sort by.
12 | */
13 | String getProperty();
14 |
15 | /**
16 | * Return whether upper and lower case in String values should be ignored.
17 | */
18 | boolean isIgnoreCase();
19 |
20 | /**
21 | * Return if ascending or descending.
22 | */
23 | boolean isAscending();
24 |
25 | }
26 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/TypeMismatchException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans;
2 |
3 | import java.beans.PropertyChangeEvent;
4 |
5 | /**
6 | * Exception thrown on a type mismatch when trying to set a property.
7 | * @author Rod Johnson
8 | * @version $Revision$
9 | */
10 | public class TypeMismatchException extends PropertyAccessException {
11 |
12 | public TypeMismatchException(PropertyChangeEvent propertyChangeEvent, Class requiredType, Throwable t) {
13 | super("Failed to convert property value of type [" +
14 | (propertyChangeEvent.getNewValue() != null ?
15 | propertyChangeEvent.getNewValue().getClass().getName() : null) +
16 | "] to required type [" + requiredType.getName() +
17 | "] for property named [" + propertyChangeEvent.getPropertyName() + "]", propertyChangeEvent, t);
18 | }
19 |
20 | }
21 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/BeanDefinitionStoreException.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.beans.factory;
3 |
4 | import com.interface21.beans.BeansException;
5 |
6 | /**
7 | * Exception thrown when a BeanFactory encounters an internal error, and
8 | * its definitions are invalid: for example, if an XML document containing
9 | * bean definitions isn't well-formed.
10 | * @author Rod Johnson
11 | */
12 | public class BeanDefinitionStoreException extends BeansException {
13 |
14 | /**
15 | * Constructs a BeanDefinitionStoreException with the specified detail message.
16 | * @param msg the detail message.
17 | * @param t the root cause of the problem with the factory.
18 | */
19 | public BeanDefinitionStoreException(String msg,Throwable t) {
20 | super(msg, t);
21 | }
22 | }
23 |
24 |
25 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/BeanIsNotAFactoryException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.beans.factory;
7 |
8 | /**
9 | * Exception thrown when a bean is not a factory,
10 | * but a user tries to get at the factory for the given bean name.
11 | * Whether a bean is a factory is determined by whether it implements
12 | * the FactoryBean interface.
13 | * @author Rod Johnson
14 | * @since 10-Mar-2003
15 | * @see com.interface21.beans.factory.FactoryBean
16 | * @version $Revision$
17 | */
18 | public class BeanIsNotAFactoryException extends BeanNotOfRequiredTypeException {
19 |
20 | public BeanIsNotAFactoryException(String name, Object actualInstance) {
21 | super(name, FactoryBean.class, actualInstance);
22 | }
23 |
24 | }
25 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/DisposableBean.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans.factory;
2 |
3 | /**
4 | * Interface to be implemented by beans that want to release resources
5 | * on destruction. A BeanFactory is supposed to invoke the destroy
6 | * method if it disposes a cached singleton. An application context
7 | * is supposed to dispose all of its singletons on close.
8 | * @author Juergen Hoeller
9 | * @since 12.08.2003
10 | * @see com.interface21.context.ApplicationContext#close
11 | */
12 | public interface DisposableBean {
13 |
14 | /**
15 | * Invoked by a BeanFactory on destruction of a singleton.
16 | * @throws Exception in case of shutdown errors.
17 | * Exceptions will get logged but not rethrown to allow
18 | * other beans to release their resources too.
19 | */
20 | void destroy() throws Exception;
21 |
22 | }
23 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/HierarchicalBeanFactory.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.beans.factory;
7 |
8 | /**
9 | * Subinterface implemented by bean factories that can be part
10 | * of a hierarchy.
11 | * @author Rod Johnson
12 | * @since 07-Jul-2003
13 | * @version $Id$
14 | */
15 | public interface HierarchicalBeanFactory extends BeanFactory {
16 |
17 | /**
18 | * Returns the parent bean factory, or null if there is none.
19 | * @return the parent bean factory, or null if there is no parent
20 | */
21 | BeanFactory getParentBeanFactory();
22 |
23 | }
24 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/InitializingBean.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.beans.factory;
3 |
4 | /**
5 | * Interface to be implemented by beans that need to react
6 | * once all their properties have been set by a BeanFactory:
7 | * for example, to perform initialization, or merely to check
8 | * that all mandatory properties have been set.
9 | * @author Rod Johnson
10 | */
11 | public interface InitializingBean {
12 |
13 | /**
14 | * Invoked by a BeanFactory after it has set all bean properties supplied.
15 | *
This method allows the bean instance to perform initialization only
16 | * possible when all bean properties have been set and to throw an
17 | * exception in the event of misconfiguration.
18 | * @throws Exception in the event of misconfiguration (such
19 | * as failure to set an essential property) or if initialization fails.
20 | */
21 | void afterPropertiesSet() throws Exception;
22 |
23 | }
24 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/NoSuchBeanDefinitionException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans.factory;
2 |
3 | import com.interface21.beans.BeansException;
4 |
5 | /**
6 | * Exception thrown when a BeanFactory is asked for a bean
7 | * instance name for which it cannot find a definition.
8 | * @author Rod Johnson
9 | * @version $Id$
10 | */
11 | public class NoSuchBeanDefinitionException extends BeansException {
12 |
13 | /** Name of the missing bean */
14 | private final String name;
15 |
16 | /**
17 | * Creates new NoSuchBeanDefinitionException..
18 | * @param name the name of the missing bean
19 | * @param message further, detailed message describing the problem.
20 | */
21 | public NoSuchBeanDefinitionException(String name, String message) {
22 | super("No bean named [" + name + "] is defined {" + message + "}", null);
23 | this.name = name;
24 | }
25 |
26 | /**
27 | * Return the name of the missing bean.
28 | * @return the name of the missing bean
29 | */
30 | public String getBeanName() {
31 | return name;
32 | }
33 |
34 | }
35 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/package.html:
--------------------------------------------------------------------------------
1 |
Package providing an alternative to the Singleton and Prototype design
patterns, including a consistent approach to configuration management.
It builds on the com.interface21.beans package.
This package and related packages are discussed in Chapter 11 of
Expert One-On-One J2EE Design and Development
by Rod Johnson (Wrox, 2002).
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/support/BeanFactoryLoader.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.beans.factory.support;
7 |
8 | import com.interface21.beans.factory.BeanFactory;
9 |
10 | /**
11 | * Interface to be implemented by objects that can load BeanFactories
12 | * (usually on behalf of application components such as EJBs).
13 | * @author Rod Johnson
14 | * @since 20-Jul-2003
15 | * @version $Id$
16 | */
17 | public interface BeanFactoryLoader {
18 |
19 | /**
20 | * Load the BeanFactory.
21 | * @return BeanFactory loaded BeanFactory. Never returns null.
22 | * @throws BootstrapException if a BeanFactory cannot be loaded
23 | */
24 | BeanFactory loadBeanFactory() throws BootstrapException;
25 |
26 | }
27 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/support/BootstrapException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans.factory.support;
2 |
3 | import com.interface21.beans.FatalBeanException;
4 |
5 | /**
6 | *
7 | * @author Rod Johnson
8 | * @since 02-Dec-02
9 | */
10 | public class BootstrapException extends FatalBeanException {
11 |
12 | /**
13 | * Constructor for BootstrapException.
14 | * @param msg
15 | * @param t
16 | */
17 | public BootstrapException(String msg, Throwable t) {
18 | super(msg, t);
19 | }
20 |
21 | }
22 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/support/ManagedList.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.beans.factory.support;
7 |
8 | import java.util.LinkedList;
9 |
10 | /**
11 | * Tag subclass used to hold managed elements, which may
12 | * include runtime bean references
13 | * @author Rod Johnson
14 | * @since 27-May-2003
15 | * @version $Id$
16 | */
17 | public class ManagedList extends LinkedList {
18 |
19 | }
20 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/support/ManagedMap.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.beans.factory.support;
7 |
8 | import java.util.HashMap;
9 |
10 | /**
11 | * Tag subclass used to hold managed values, which may
12 | * include runtime bean references
13 | * @author Rod Johnson
14 | * @since 27-May-2003
15 | * @version $Id$
16 | */
17 | public class ManagedMap extends HashMap {
18 |
19 | }
20 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/support/RuntimeBeanReference.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans.factory.support;
2 |
3 | /**
4 | * Immutable placeholder class used for the value of a PropertyValue
5 | * object when it's a reference to another bean in this
6 | * factory to be resolved at runtime.
7 | * @author Rod Johnson
8 | */
9 | public class RuntimeBeanReference {
10 |
11 | private final String beanName;
12 |
13 | /**
14 | * Create a new RuntimeBeanReference to the given bean nam.
15 | * @param beanName name of the target bean.
16 | */
17 | public RuntimeBeanReference(String beanName) {
18 | this.beanName = beanName;
19 | }
20 |
21 | /**
22 | * Return the target bean name.
23 | * @return the target bean name.
24 | */
25 | public String getBeanName() {
26 | return beanName;
27 | }
28 | }
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/support/package.html:
--------------------------------------------------------------------------------
1 |
Classes supporting the com.interface21.beans.factory package.
Contains abstract base classes for BeanFactory implementations.
--------------------------------------------------------------------------------
/src/com/interface21/beans/factory/xml/package.html:
--------------------------------------------------------------------------------
1 |
Contains an abstract XML-based BeanFactory implementation,
including a standard "spring-beans" DTD.
--------------------------------------------------------------------------------
/src/com/interface21/beans/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | This package contains interfaces and classes for manipulating Java beans.
5 | It is used by most other Spring packages.
6 |
7 |
A BeanWrapper object may be used to set and get bean properties,
8 | singly or in bulk.
9 |
10 |
The classes in this package are discussed in Chapter 11 of
11 | Expert One-On-One J2EE Design and Development
12 | by Rod Johnson (Wrox, 2002).
13 |
14 |
15 |
16 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/propertyeditors/ClassEditor.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans.propertyeditors;
2 |
3 | import java.beans.PropertyEditorSupport;
4 |
5 | /**
6 | * Editor for java.lang.Class, to directly feed a Class property
7 | * instead of needing an additional class name property.
8 | * @author Juergen Hoeller
9 | * @since 13.05.2003
10 | */
11 | public class ClassEditor extends PropertyEditorSupport {
12 |
13 | public void setAsText(String text) throws IllegalArgumentException {
14 | Class clazz = null;
15 | try {
16 | clazz = Class.forName(text);
17 | }
18 | catch (ClassNotFoundException ex) {
19 | throw new IllegalArgumentException("Invalid class name [" + text + "]: " + ex.getMessage());
20 | }
21 | setValue(clazz);
22 | }
23 |
24 | public String getAsText() {
25 | return ((Class) getValue()).getName();
26 | }
27 |
28 | }
29 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/propertyeditors/LocaleEditor.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans.propertyeditors;
2 |
3 | import java.beans.PropertyEditorSupport;
4 | import java.util.Locale;
5 |
6 | import com.interface21.util.StringUtils;
7 |
8 | /**
9 | * Editor for java.util.Locale, to directly feed a Locale property.
10 | * Expects the same syntax as Locale.toString, i.e. language + optionally
11 | * country + optionally variant, separated by "_" (e.g. "en", "en_US").
12 | * @author Juergen Hoeller
13 | * @since 26.05.2003
14 | */
15 | public class LocaleEditor extends PropertyEditorSupport {
16 |
17 | public void setAsText(String text) {
18 | String[] parts = StringUtils.delimitedListToStringArray(text, "_");
19 | String language = parts.length > 0 ? parts[0] : "";
20 | String country = parts.length > 1 ? parts[1] : "";
21 | String variant = parts.length > 2 ? parts[2] : "";
22 | setValue(language.length() > 0 ? new Locale(language, country, variant) : null);
23 | }
24 |
25 | }
26 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/propertyeditors/StringArrayPropertyEditor.java:
--------------------------------------------------------------------------------
1 | package com.interface21.beans.propertyeditors;
2 |
3 | import java.beans.PropertyEditorSupport;
4 |
5 | import com.interface21.util.StringUtils;
6 |
7 | /**
8 | * Properties editor for String[] type. Strings must be in CSV format.
9 | * This property editor is automatically registered by BeanWrapperImpl.
10 | * @author Rod Johnson
11 | * @see com.interface21.beans.BeanWrapperImpl
12 | */
13 | public class StringArrayPropertyEditor extends PropertyEditorSupport {
14 |
15 | public void setAsText(String s) throws IllegalArgumentException {
16 | String[] sa = StringUtils.commaDelimitedListToStringArray(s);
17 | setValue(sa);
18 | }
19 |
20 | public String getAsText() {
21 | String[] array = (String[]) this.getValue();
22 | return StringUtils.arrayToCommaDelimitedString(array);
23 | }
24 |
25 | }
26 |
--------------------------------------------------------------------------------
/src/com/interface21/beans/propertyeditors/package.html:
--------------------------------------------------------------------------------
1 |
Properties editors used to convert from String values to object
types such as java.util.Properties.
Some of these editors are registered automatically by BeanWrapperImpl.
"CustomXxxEditor" classes are intended for manual registration in
specific binding processes, as they are localized or the like.
--------------------------------------------------------------------------------
/src/com/interface21/context/ApplicationContextException.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.context;
3 |
4 | import com.interface21.core.NestedRuntimeException;
5 |
6 | /**
7 | * Exception thrown during application context initialization.
8 | * @author Rod Johnson
9 | */
10 | public class ApplicationContextException extends NestedRuntimeException {
11 |
12 | /**
13 | * Constructs an ApplicationContextException
14 | * with the specified detail message and no root cause.
15 | * @param msg the detail message.
16 | */
17 | public ApplicationContextException(String msg) {
18 | super(msg);
19 | }
20 |
21 | /**
22 | * @see NestedRuntimeException#NestedRuntimeException(String, Throwable)
23 | */
24 | public ApplicationContextException(String msg, Throwable t) {
25 | super(msg, t);
26 | }
27 | }
28 |
29 |
30 |
--------------------------------------------------------------------------------
/src/com/interface21/context/ApplicationEventMulticaster.java:
--------------------------------------------------------------------------------
1 | package com.interface21.context;
2 |
3 | /**
4 | * Subinterface of ApplicationListener to be implemented by
5 | * listeners that can broadcast events to other listeners.
6 | * @author Rod Johnson
7 | */
8 | public interface ApplicationEventMulticaster extends ApplicationListener {
9 |
10 | /**
11 | * Add a listener to be notified of all events
12 | * @param listener listener to add
13 | */
14 | void addApplicationListener(ApplicationListener listener);
15 |
16 | /**
17 | * Remove a listener in the notification list]
18 | * @param listener listener to remove
19 | */
20 | void removeApplicationListener(ApplicationListener listener);
21 |
22 | /**
23 | * Remove all listeners registered with this multicaster.
24 | * It will perform no action on event notification until more
25 | * listeners are registered.
26 | */
27 | void removeAllListeners();
28 |
29 | }
30 |
31 |
--------------------------------------------------------------------------------
/src/com/interface21/context/ApplicationListener.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Generic framework code included with
3 | * Expert One-On-One J2EE Design and Development
4 | * by Rod Johnson (Wrox, 2002).
5 | * This code is free to use and modify.
6 | * Please contact rod.johnson@interface21.com
7 | * for commercial support.
8 | */
9 |
10 |
11 | package com.interface21.context;
12 |
13 | import java.util.EventListener;
14 |
15 | /**
16 | * Interface to be implemented by event listeners.
17 | * Based on standard java.util base class for Observer
18 | * design pattern.
19 | * @author Rod Johnson
20 | */
21 | public interface ApplicationListener extends EventListener {
22 |
23 | /**
24 | * Handle an application event
25 | * @param e event to respond to
26 | */
27 | void onApplicationEvent(ApplicationEvent e);
28 |
29 | }
30 |
31 |
--------------------------------------------------------------------------------
/src/com/interface21/context/MessageSourceResolvable.java:
--------------------------------------------------------------------------------
1 | package com.interface21.context;
2 |
3 | /**
4 | * Interface for objects that are suitable for message resolution,
5 | * e.g. validation errors.
6 | * @author Tony Falabella
7 | * @see MessageSource#getMessage
8 | */
9 | public interface MessageSourceResolvable {
10 |
11 | /**
12 | * Return the codes to be used to resolve this message,
13 | * in the order they should get tried. The last code will
14 | * therefore be the default one.
15 | * @return a String code associated with this message
16 | */
17 | public String[] getCodes();
18 |
19 | /**
20 | * Return the array of args to be used to resolve this message.
21 | * @return An array of objects to be used as params to replace
22 | * placeholders within the code message text.
23 | */
24 | public Object[] getArgs();
25 |
26 | /**
27 | * Return the defaultMessage to be used to resolve this message.
28 | * @return The defaultMessage, or null if no default.
29 | */
30 | public String getDefaultMessage();
31 | }
32 |
--------------------------------------------------------------------------------
/src/com/interface21/context/NestingMessageSource.java:
--------------------------------------------------------------------------------
1 | package com.interface21.context;
2 |
3 | /**
4 | * Subinterface of MessageSource to be implemented by objects that
5 | * can resolve messages hierarchically.
6 | * @author Rod Johnson
7 | * @version $RevisionId$
8 | */
9 | public interface NestingMessageSource extends MessageSource {
10 |
11 | /**
12 | * Set the parent that will be used to try to resolve messages
13 | * that this object can't resolve.
14 | * @param parent parent MessageSource that will be used to
15 | * resolve messages that this object can't resolve.
16 | * May be null, in which case no further resolution is possible.
17 | */
18 | void setParent(MessageSource parent);
19 | }
20 |
21 |
--------------------------------------------------------------------------------
/src/com/interface21/context/NoSuchMessageException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.context;
2 |
3 | import java.util.Locale;
4 |
5 | /**
6 | * Exception thrown when a message can't be resolved.
7 | * @author Rod Johnson
8 | */
9 | public class NoSuchMessageException extends Exception {
10 |
11 | /**
12 | * Create a new exception.
13 | * @param code code that could not be resolved for given locale
14 | * @param locale locale that was used to search for the code within
15 | */
16 | public NoSuchMessageException(String code, Locale locale) {
17 | super("No message found under code '" + code + "' for locale '" + locale + "'.");
18 | }
19 |
20 | /**
21 | * Create a new exception.
22 | * @param code code that could not be resolved for given locale
23 | */
24 | public NoSuchMessageException(String code) {
25 | super("No message found under code '" + code + "' for locale '" + Locale.getDefault() + "'.");
26 | }
27 |
28 | }
29 |
30 |
--------------------------------------------------------------------------------
/src/com/interface21/context/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | This package builds on the beans package to add support for
5 | message sources and for the Observer design pattern, and the
6 | ability for application objects to obtain resources using a
7 | consistent API.
8 |
9 |
There is no necessity for Spring applications to depend
10 | on ApplicationContext or even BeanFactory functionality
11 | explicitly. One of the strengths of the Spring architecture
12 | is that application objects can often be configured without
13 | any dependency on Spring-specific APIs.
14 |
15 |
16 |
17 |
--------------------------------------------------------------------------------
/src/com/interface21/context/support/ConsoleListener.java:
--------------------------------------------------------------------------------
1 | package com.interface21.context.support;
2 |
3 | import com.interface21.context.ApplicationEvent;
4 | import com.interface21.context.ApplicationListener;
5 |
6 | /**
7 | * Simple listener for debug use only that logs messages
8 | * to the console.
9 | *
10 | *
Classes supporting the com.interface21.context package,
such as abstract base classes for ApplicationContext
implementations and a MessageSource implementation.
--------------------------------------------------------------------------------
/src/com/interface21/core/ErrorCoded.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.core;
3 |
4 | /**
5 | * Interface that can be implemented by exceptions etc that are error coded.
6 | * The error code is a String, rather than a number, so it can be given
7 | * user-readable values, such as "object.failureDescription".
8 | * These codes will be resolved by a cMessageSource object.
9 | *
10 | *
This interface is necessary because both runtime and checked
11 | * exceptions are useful, and they cannot share a common,
12 | * framework-specific, superclass.
13 | *
14 | * @author Rod Johnson
15 | * @version $Id$
16 | * @see com.interface21.context.MessageSource
17 | */
18 | public interface ErrorCoded {
19 |
20 | /**
21 | * Return the error code associated with this failure.
22 | * The GUI can render this anyway it pleases, allowing for Int8ln etc.
23 | * @return a String error code associated with this failure,
24 | * or null if not error-coded
25 | */
26 | String getErrorCode();
27 |
28 | }
29 |
30 |
--------------------------------------------------------------------------------
/src/com/interface21/core/HasRootCause.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.core;
3 |
4 | /**
5 | * Interface to be implemented by exceptions that have
6 | * a root cause.
7 | * This enables exceptions that don't share a common superclass
8 | * to expose a root cause consistently.
9 | * This will no longer be necessary in Java 1.4,
10 | * although it won't be incompatible.
11 | * @author Rod Johnson
12 | * @version $Id$
13 | */
14 | public interface HasRootCause {
15 |
16 | /**
17 | * Return the root cause of this exception
18 | * @return the root cause of this exception,
19 | * or null if there was no root cause
20 | */
21 | Throwable getRootCause();
22 |
23 | }
24 |
25 |
--------------------------------------------------------------------------------
/src/com/interface21/core/InternalErrorException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.core;
2 |
3 | /**
4 | * InternalErrorException denotes an internal error in the framework.
5 | * Assertions are useful while debugging/testing the code, but a
6 | * different mechanism is needed to catch internal framework errors in
7 | * production.
8 | * @author Isabelle Muszynski
9 | * @since 5 April 2003
10 | */
11 |
12 | public class InternalErrorException extends NestedRuntimeException {
13 |
14 | /**
15 | * Default constructor
16 | **/
17 | public InternalErrorException() {
18 | super("Internal error");
19 | }
20 |
21 | /**
22 | * Constructor
23 | * @param msg the exception message
24 | **/
25 | public InternalErrorException(String msg) {
26 | super(msg);
27 | }
28 |
29 | /**
30 | * Constructor
31 | * @param msg the exception message
32 | * @param ex the nested exception
33 | **/
34 | public InternalErrorException(String msg, Throwable ex) {
35 | super(msg, ex);
36 | }
37 | }
38 |
--------------------------------------------------------------------------------
/src/com/interface21/core/OrderComparator.java:
--------------------------------------------------------------------------------
1 | package com.interface21.core;
2 |
3 | import java.util.Comparator;
4 |
5 | /**
6 | * Comparator implementation for Ordered objects,
7 | * sorting by order value ascending (resp. by priority descending).
8 | *
9 | *
Non-Ordered objects are treated as greatest order values,
10 | * thus ending up at the end of the list, in arbitrary order
11 | * (just like same order values of Ordered objects).
12 | *
13 | * @author Juergen Hoeller
14 | * @since 07.04.2003
15 | * @see Ordered
16 | */
17 | public class OrderComparator implements Comparator {
18 |
19 | public int compare(Object o1, Object o2) {
20 | int i1 = (o1 instanceof Ordered ? ((Ordered) o1).getOrder() : Integer.MAX_VALUE);
21 | int i2 = (o2 instanceof Ordered ? ((Ordered) o2).getOrder() : Integer.MAX_VALUE);
22 |
23 | // direct evaluation instead of Integer.compareTo to avoid unnecessary object creation
24 | if (i1 < i2)
25 | return -1;
26 | else if (i1 > i2)
27 | return 1;
28 | else
29 | return 0;
30 | }
31 | }
32 |
--------------------------------------------------------------------------------
/src/com/interface21/core/Ordered.java:
--------------------------------------------------------------------------------
1 | package com.interface21.core;
2 |
3 | /**
4 | * Interface that can be implemented by objects that should be
5 | * orderable, e.g. in a Collection. The actual order can be
6 | * interpreted as prioritization, the first object (with the
7 | * lowest order value) having the highest priority.
8 | *
9 | * @author Juergen Hoeller
10 | * @since 07.04.2003
11 | */
12 | public interface Ordered {
13 |
14 | /**
15 | * Return the order value of this object,
16 | * higher value meaning greater in terms of sorting.
17 | * Normally starting with 0 or 1, Integer.MAX_VALUE
18 | * indicating greatest.
19 | * Same order values will result in arbitrary positions
20 | * for the affected objects.
21 | *
22 | *
Higher value can be interpreted as lower priority,
23 | * consequently the first object has highest priority
24 | * (somewhat analogous to Servlet "load-on-startup" values).
25 | *
26 | * @return the order value
27 | */
28 | public int getOrder();
29 | }
30 |
--------------------------------------------------------------------------------
/src/com/interface21/core/TimeStamped.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.core;
3 |
4 | /**
5 | * This interface can be implemented by cacheable objects
6 | * or cache entries, to enable the freshness of objects
7 | * to be checked.
8 | * @author Rod Johnson
9 | */
10 | public interface TimeStamped {
11 |
12 | /**
13 | * Return the timestamp for this object
14 | * @return long the timestamp for this object,
15 | * as returned by System.currentTimeMillis()
16 | */
17 | long getTimeStamp();
18 |
19 | }
20 |
--------------------------------------------------------------------------------
/src/com/interface21/core/package.html:
--------------------------------------------------------------------------------
1 |
Some basic classes facilitating exception handling,
internationalization, and the Visitor design pattern.
--------------------------------------------------------------------------------
/src/com/interface21/dao/DataAccessResourceFailureException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Generic framework code included with
3 | * Expert One-On-One J2EE Design and Development
4 | * by Rod Johnson (Wrox, 2002).
5 | * This code is free to use and modify.
6 | * Please contact rod.johnson@interface21.com
7 | * for commercial support.
8 | */
9 |
10 | package com.interface21.dao;
11 |
12 | /**
13 | * Data access exception thrown when a resource fails
14 | * completely: for example, if we can't connect to a database
15 | * using JDBC.
16 | * @author Rod Johnson
17 | * @version $Id$
18 | */
19 | public class DataAccessResourceFailureException extends DataAccessException {
20 |
21 | /**
22 | * Constructor for ResourceFailureDataAccessException.
23 | * @param msg message
24 | * @param ex root cause from data access API in use
25 | */
26 | public DataAccessResourceFailureException(String msg, Throwable ex) {
27 | super(msg, ex);
28 | }
29 |
30 | }
31 |
--------------------------------------------------------------------------------
/src/com/interface21/dao/DataIntegrityViolationException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Generic framework code included with
3 | * Expert One-On-One J2EE Design and Development
4 | * by Rod Johnson (Wrox, 2002).
5 | * This code is free to use and modify.
6 | * Please contact rod.johnson@interface21.com
7 | * for commercial support.
8 | */
9 |
10 | package com.interface21.dao;
11 |
12 | /**
13 | * Exception thrown when an attempt to insert or update data
14 | * results in violation of an integrity constraint. Note that this
15 | * is not purely a relational concept; unique primary keys are
16 | * required by most database types.
17 | * @author Rod Johnson
18 | * @version $Id$
19 | */
20 | public class DataIntegrityViolationException extends DataAccessException {
21 |
22 | /**
23 | * Constructor for DataIntegrityViolationException.
24 | * @param msg mesg
25 | * @param ex root cause
26 | */
27 | public DataIntegrityViolationException(String msg, Throwable ex) {
28 | super(msg, ex);
29 | }
30 |
31 | }
32 |
--------------------------------------------------------------------------------
/src/com/interface21/dao/DeadlockLoserDataAccessException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Generic framework code included with
3 | * Expert One-On-One J2EE Design and Development
4 | * by Rod Johnson (Wrox, 2002).
5 | * This code is free to use and modify.
6 | * Please contact rod.johnson@interface21.com
7 | * for commercial support.
8 | */
9 |
10 | package com.interface21.dao;
11 |
12 | /**
13 | * Generic exception thrown when the current process was
14 | * a deadlock loser, and its transaction rolled back.
15 | * @author Rod Johnson
16 | * @version $Id$
17 | */
18 | public class DeadlockLoserDataAccessException extends DataAccessException {
19 |
20 | /**
21 | * Constructor for DeadlockLoserDataAccessException.
22 | * @param msg mesg
23 | * @param ex root cause
24 | */
25 | public DeadlockLoserDataAccessException(String msg, Throwable ex) {
26 | super(msg, ex);
27 | }
28 |
29 | }
30 |
--------------------------------------------------------------------------------
/src/com/interface21/dao/TypeMismatchDataAccessException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Generic framework code included with
3 | * Expert One-On-One J2EE Design and Development
4 | * by Rod Johnson (Wrox, 2002).
5 | * This code is free to use and modify.
6 | * Please contact rod.johnson@interface21.com
7 | * for commercial support.
8 | */
9 |
10 | package com.interface21.dao;
11 |
12 | /**
13 | * Exception thrown on mismatch between Java type and database type:
14 | * for example on an attempt to set an object of the wrong type
15 | * in an RDBMS column.
16 | * @author Rod Johnson
17 | * @version $Id$
18 | */
19 | public class TypeMismatchDataAccessException extends DataAccessException {
20 |
21 | /**
22 | * Constructor for TypeMismatchDataAccessException.
23 | * @param msg mesg
24 | * @param ex root cause
25 | */
26 | public TypeMismatchDataAccessException(String msg, Throwable ex) {
27 | super(msg, ex);
28 | }
29 |
30 | }
31 |
--------------------------------------------------------------------------------
/src/com/interface21/dao/package.html:
--------------------------------------------------------------------------------
1 |
Exception hierarchy enabling sophisticated error handling independent
of the data access approach in use. For example, when DAOs and data
access frameworks use the exceptions in this package (and custom
subclasses), calling code can detect and handle common problems such
as deadlocks without being tied to a particular data access strategy,
such as JDBC.
All these exceptions are unchecked, meaning that calling code can
leave them uncaught and treat all data access exceptions as fatal.
The classes in this package are discussed in Chapter 9 of
Expert One-On-One J2EE Design and Development
by Rod Johnson (Wrox, 2002).
--------------------------------------------------------------------------------
/src/com/interface21/ejb/access/AbstractRemoteSlsbInvokerInterceptor.java:
--------------------------------------------------------------------------------
1 | package com.interface21.ejb.access;
2 |
3 | import javax.ejb.EJBObject;
4 |
5 | /**
6 | * Superclass for interceptors proxying remote EJBs.
7 | * @author Rod Johnson
8 | * @version $Revision$
9 | */
10 | public abstract class AbstractRemoteSlsbInvokerInterceptor extends AbstractSlsbInvokerInterceptor {
11 |
12 | /**
13 | * Return a new instance of the stateless session bean.
14 | * Can be overridden to change the algorithm.
15 | * @return EJBObject
16 | */
17 | protected EJBObject newSessionBeanInstance() {
18 | if (logger.isDebugEnabled())
19 | logger.debug("Trying to create EJB");
20 |
21 | EJBObject session = (EJBObject) getHomeBeanWrapper().invoke(CREATE_METHOD, null);
22 |
23 | // if it throws remote exception (wrapped in bean exception, retry?)
24 |
25 | if (logger.isDebugEnabled())
26 | logger.debug("EJB created OK [" + session + "]");
27 | return session;
28 | }
29 |
30 | }
31 |
--------------------------------------------------------------------------------
/src/com/interface21/ejb/support/AbstractJmsMessageDrivenBean.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.ejb.support;
7 |
8 | import javax.jms.MessageListener;
9 |
10 | /**
11 | * Convenient superclass for JMS MDBs.
12 | * Requires subclasses to implement the JMS interface MessageListener.
13 | * @author Rod Johnson
14 | * @version $RevisionId: ResultSetHandler.java,v 1.1 2001/09/07 12:48:57 rod Exp $
15 | */
16 | public abstract class AbstractJmsMessageDrivenBean
17 | extends AbstractMessageDrivenBean
18 | implements MessageListener {
19 |
20 | // Empty: the purpose of this class is to ensure
21 | // that subclasses implement javax.jms.MessageListener
22 |
23 | }
24 |
--------------------------------------------------------------------------------
/src/com/interface21/ejb/support/AbstractStatefulSessionBean.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.ejb.support;
7 |
8 | import javax.ejb.CreateException;
9 |
10 | /**
11 | * Convenient superclass for stateful session beans.
12 | * SFSBs should extend this class, leaving them to implement
13 | * the ejbActivate() and ejbPassivate() lifecycle methods
14 | * to comply with the requirements of the EJB specification.
15 | *
16 | *
NB: Subclasses should invoke the loadBeanFactory()
17 | * method in their custom ejbCreate() methods.
18 | *
19 | * @version $Id$
20 | * @author Rod Johnson
21 | */
22 | public abstract class AbstractStatefulSessionBean extends AbstractSessionBean {
23 |
24 | /**
25 | * Load a Spring BeanFactory namespace. Exposed for subclasses
26 | * to load a BeanFactory in their ejbCreate() methods.
27 | */
28 | protected void loadBeanFactory() throws CreateException {
29 | super.loadBeanFactory();
30 | }
31 |
32 | }
33 |
--------------------------------------------------------------------------------
/src/com/interface21/ejb/support/package.html:
--------------------------------------------------------------------------------
1 |
Superclasses to make implementing EJBs simpler and less error-prone,
as well as guaranteeing a Spring BeanFactory is available
to EJBs. This promotes good practice, with EJB services used
for transaction management, thread management, and (possibly) remoting,
while business logic is implemented in easily testable POJOs.
In this model, the EJB is a facade, with as many POJO helpers behind
the BeanFactory as are required.
The classes in this package are discussed in Chapter 11 of
Expert One-On-One J2EE Design and Development
by Rod Johnson (Wrox, 2002).
The present version has changed somewhat, but has the same goals.
Note that the default behaviour is to look for an EJB enviroment variable
with name ejb/BeanFactoryPath that specifies the
location on the classpath of an XML bean factory definition
file (such as /com/mycom/mypackage/mybeans.xml.
If this JNDI key is missing, your EJB subclass won't
successfully initialize in the container.
--------------------------------------------------------------------------------
/src/com/interface21/jdbc/core/ResultReader.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Generic framework code included with
3 | * Expert One-On-One J2EE Design and Development
4 | * by Rod Johnson (Wrox, 2002).
5 | * This code is free to use and modify.
6 | * Please contact rod.johnson@interface21.com
7 | * for commercial support.
8 | */
9 |
10 | package com.interface21.jdbc.core;
11 |
12 | import java.util.List;
13 |
14 |
15 | /**
16 | * Extension of RowCallbackHandler interfaces that saves the
17 | * accumulated results as a Collection.
18 | * @author Rod Johnson
19 | */
20 | public interface ResultReader extends RowCallbackHandler {
21 |
22 | /**
23 | * Return all results, disconnected from the JDBC ResultSet.
24 | * @return all results, disconnected from the JDBC ResultSet.
25 | * Never returns null; returns the empty collection if there
26 | * were no results.
27 | */
28 | List getResults();
29 |
30 | }
31 |
32 |
--------------------------------------------------------------------------------
/src/com/interface21/jdbc/core/SQLWarningException.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.jdbc.core;
3 |
4 | import java.sql.SQLWarning;
5 |
6 | import com.interface21.dao.UncategorizedDataAccessException;
7 |
8 | /**
9 | * Exception thrown when we're not ignoring warnings.
10 | * If such an exception is thrown, the operation completed,
11 | * so we will need to explicitly roll it back if we're not happy
12 | * on looking at the warning. We might choose to ignore (or merely log)
13 | * the warning and throw the exception away.
14 | * @author Rod Johnson
15 | */
16 | public class SQLWarningException extends UncategorizedDataAccessException {
17 |
18 | /**
19 | * Constructor for ConnectionFactoryException.
20 | * @param s message
21 | * @param ex JDBC warning
22 | */
23 | public SQLWarningException(String mesg, SQLWarning ex) {
24 | super(mesg, ex);
25 | }
26 |
27 | /**
28 | * Return the SQLWarning.
29 | * @return the SQLWarning
30 | */
31 | public SQLWarning SQLWarning() {
32 | return (SQLWarning) getRootCause();
33 | }
34 |
35 |
36 | }
37 |
--------------------------------------------------------------------------------
/src/com/interface21/jdbc/core/package.html:
--------------------------------------------------------------------------------
1 |
The classes in this package make JDBC easier to use and
reduce the likelihood of common errors. In particular, they:
Simplify error handling, avoiding the need for try/catch/final
blocks in application code.
Present exceptions to application code in a generic hierarchy of
unchecked exceptions, enabling applications to catch data access
exceptions without being dependent on JDBC, and to ignore fatal
exceptions there is no value in catching.
Allow the implementation of error handling to be modified
to target different RDBMSes without introducing proprietary
dependencies into application code.
This package and related packages are discussed in Chapter 9 of
Expert One-On-One J2EE Design and Development
by Rod Johnson (Wrox, 2002).
--------------------------------------------------------------------------------
/src/com/interface21/jdbc/core/support/package.html:
--------------------------------------------------------------------------------
1 |
Classes supporting the com.interface21.jdbc.core package.
Contains various SQLExceptionTranslater and
DataFieldMaxValueIncrementer implementations,
and a DAO base class for JdbcTemplate usage.
--------------------------------------------------------------------------------
/src/com/interface21/jdbc/datasource/CannotGetJdbcConnectionException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Generic framework code included with
3 | * Expert One-On-One J2EE Design and Development
4 | * by Rod Johnson (Wrox, 2002).
5 | * This code is free to use and modify.
6 | * Please contact rod.johnson@interface21.com
7 | * for commercial support.
8 | */
9 |
10 | package com.interface21.jdbc.datasource;
11 |
12 | import com.interface21.dao.DataAccessResourceFailureException;
13 |
14 | /**
15 | * Fatal exception thrown when we can't connect to an RDBMS
16 | * using JDBC.
17 | * @author Rod Johnson
18 | */
19 | public class CannotGetJdbcConnectionException extends DataAccessResourceFailureException {
20 |
21 | /**
22 | * Constructor for CannotGetJdbcConnectionException.
23 | * @param s message
24 | * @param ex root cause
25 | */
26 | public CannotGetJdbcConnectionException(String s, Throwable ex) {
27 | super(s, ex);
28 | }
29 |
30 | }
31 |
--------------------------------------------------------------------------------
/src/com/interface21/jdbc/datasource/ConnectionHolder.java:
--------------------------------------------------------------------------------
1 | package com.interface21.jdbc.datasource;
2 |
3 | import java.sql.Connection;
4 |
5 | /**
6 | * Connection holder, wrapping a JDBC Connection.
7 | * Features rollback-only support for nested JDBC transactions.
8 | *
9 | *
DataSourceTransactionManager binds instances of this class
10 | * to the thread, for a given DataSource.
11 | *
12 | *
Note: This is an SPI class, not intended to be used by applications.
13 | *
14 | * @author Juergen Hoeller
15 | * @since 06.05.2003
16 | * @see DataSourceTransactionManager
17 | * @see DataSourceTransactionObject
18 | * @see DataSourceUtils
19 | */
20 | public class ConnectionHolder {
21 |
22 | private final Connection connection;
23 |
24 | private boolean rollbackOnly;
25 |
26 | public ConnectionHolder(Connection connection) {
27 | this.connection = connection;
28 | }
29 |
30 | public Connection getConnection() {
31 | return connection;
32 | }
33 |
34 | public void setRollbackOnly() {
35 | this.rollbackOnly = true;
36 | }
37 |
38 | public boolean isRollbackOnly() {
39 | return rollbackOnly;
40 | }
41 |
42 | }
43 |
--------------------------------------------------------------------------------
/src/com/interface21/jdbc/datasource/package.html:
--------------------------------------------------------------------------------
1 |
Provides a utility class for easy DataSource access,
and various simple DataSource implementations.
--------------------------------------------------------------------------------
/src/com/interface21/jdbc/object/package.html:
--------------------------------------------------------------------------------
1 |
The classes in this package represent RDBMS queries, updates,
and stored procedures as threadsafe, reusable objects. This approach
is modelled by JDO, although of course objects returned by queries
are "disconnected" from the database.
This higher level of JDBC abstraction depends on the lower-level
abstraction in the com.interface21.jdbc.core package. Exceptions
thrown are as in the com.interface21.dao package, meaning that code
using this package does not need to implement JDBC or RDBMS-specific
error handling.
This package and related packages are discussed in Chapter 9 of
Expert One-On-One J2EE Design and Development
by Rod Johnson (Wrox, 2002).
--------------------------------------------------------------------------------
/src/com/interface21/jdbc/util/package.html:
--------------------------------------------------------------------------------
1 |
Contains miscellaneous JDBC utilities.
--------------------------------------------------------------------------------
/src/com/interface21/jndi/package.html:
--------------------------------------------------------------------------------
1 |
The classes in this package make JNDI easier to use,
facilitating the accessing of configuration stored in JNDI,
and provide useful superclasses for JNDI access classes.
In particular, application classes using this package do not
need to catch naming exceptions or obtain JNDI contexts.
The classes in this package are discussed in Chapter 11 of
Expert One-On-One J2EE Design and Development
by Rod Johnson (Wrox, 2002).
--------------------------------------------------------------------------------
/src/com/interface21/jndi/support/package.html:
--------------------------------------------------------------------------------
1 |
The simplest implementation of the JNDI SPI that could possibly work.
Useful for setting up a simple JNDI environment for test suites
or standalone applications. If e.g. JDBC DataSources get bound to the
same JNDI names as within a J2EE container, both application code and
configuration can me reused without changes.
--------------------------------------------------------------------------------
/src/com/interface21/orm/hibernate/HibernateJdbcException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.orm.hibernate;
2 |
3 | import net.sf.hibernate.JDBCException;
4 |
5 | import com.interface21.dao.UncategorizedDataAccessException;
6 |
7 | /**
8 | * Hibernate-specific subclass of DataAccessException, for JDBC exceptions
9 | * that Hibernate rethrew. Used by HibernateTemplate.
10 | *
11 | *
Part of the general strategy to allow for using Hibernate within
12 | * application service implementations that just feature DataAccessException
13 | * in their interfaces. Clients of these services do not need to be aware of
14 | * the particular data access strategy used by the service implementations.
15 | *
16 | * @author Juergen Hoeller
17 | * @since 02.05.2003
18 | * @see HibernateTemplate
19 | * @see com.interface21.dao
20 | */
21 | public class HibernateJdbcException extends UncategorizedDataAccessException {
22 |
23 | public HibernateJdbcException(String s, JDBCException ex) {
24 | super(s, ex.getSQLException());
25 | }
26 |
27 | }
28 |
--------------------------------------------------------------------------------
/src/com/interface21/orm/hibernate/HibernateSystemException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.orm.hibernate;
2 |
3 | import net.sf.hibernate.HibernateException;
4 |
5 | import com.interface21.dao.UncategorizedDataAccessException;
6 |
7 | /**
8 | * Hibernate-specific subclass of DataAccessException, for Hibernate system
9 | * errors that do not match any concrete com.interface21.dao exceptions.
10 | * Used by HibernateTemplate.
11 | *
12 | *
Part of the general strategy to allow for using Hibernate within
13 | * application service implementations that just feature DataAccessException
14 | * in their interfaces. Clients of these services do not need to be aware of
15 | * the particular data access strategy used by the service implementations.
16 | *
17 | * @author Juergen Hoeller
18 | * @since 02.05.2003
19 | * @see HibernateTemplate
20 | * @see com.interface21.dao
21 | */
22 | public class HibernateSystemException extends UncategorizedDataAccessException {
23 |
24 | public HibernateSystemException(String msg, HibernateException ex) {
25 | super(msg, ex);
26 | }
27 |
28 | }
29 |
--------------------------------------------------------------------------------
/src/com/interface21/orm/hibernate/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Package providing integration of Hibernate with Spring concepts.
5 | Contains SessionFactory helper classes, a template plus callback
6 | for Hibernate access, and a Hibernate implementation of Spring's
7 | transaction SPI.
8 |
9 |
10 |
11 |
--------------------------------------------------------------------------------
/src/com/interface21/orm/hibernate/support/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Classes supporting the com.interface21.orm.hibernate package.
5 | Contains a DAO base class for HibernateTemplate usage.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/orm/jdo/JdoSystemException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.orm.jdo;
2 |
3 | import com.interface21.dao.UncategorizedDataAccessException;
4 |
5 | /**
6 | * JDO exception that gets thrown on system errors.
7 | * @author Juergen Hoeller
8 | * @since 03.06.2003
9 | */
10 | public class JdoSystemException extends UncategorizedDataAccessException {
11 |
12 | public JdoSystemException(String s, Throwable ex) {
13 | super(s, ex);
14 | }
15 |
16 | }
17 |
--------------------------------------------------------------------------------
/src/com/interface21/orm/jdo/JdoUsageException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.orm.jdo;
2 |
3 | import com.interface21.dao.InvalidDataAccessApiUsageException;
4 |
5 | /**
6 | * JDO exception that gets thrown on invalid API usage.
7 | * @author Juergen Hoeller
8 | * @since 03.06.2003
9 | */
10 | public class JdoUsageException extends InvalidDataAccessApiUsageException {
11 |
12 | public JdoUsageException(String s, Throwable ex) {
13 | super(s, ex);
14 | }
15 |
16 | }
17 |
--------------------------------------------------------------------------------
/src/com/interface21/orm/jdo/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Package providing integration of JDO with Spring concepts.
5 | Contains PersistenceManagerFactory helper classes, a template plus
6 | callback for JDO access, and a JDO implementation of Spring's
7 | transaction SPI.
8 |
9 |
10 |
11 |
--------------------------------------------------------------------------------
/src/com/interface21/orm/jdo/support/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Classes supporting the com.interface21.orm.jdo package.
5 | Contains a DAO base class for JdoTemplate usage.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/remoting/caucho/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Remoting classes for Caucho's Hessian and Burlap protocols.
5 | Provides a proxy factory for accessing Hessian/Burlap services,
6 | and an exporter for making beans available for Hessian/Burlap clients.
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/src/com/interface21/remoting/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Exception hierarchy for Spring's remoting infrastructure,
5 | independent of any specific remote method invocation system.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/remoting/rmi/RemoteInvocationHandler.java:
--------------------------------------------------------------------------------
1 | package com.interface21.remoting.rmi;
2 |
3 | import java.rmi.Remote;
4 |
5 | /**
6 | * Interface for RemoteInvocationWrapper instances on the server.
7 | * A client's StubInvocationHandler uses a stub implementing this interface.
8 | *
9 | * @author Juergen Hoeller
10 | * @since 14.05.2003
11 | */
12 | interface RemoteInvocationHandler extends Remote {
13 |
14 | /**
15 | * Called by the StubInvocationHandler on each invocation.
16 | * Invokes the given method with the given parameters on the actual object.
17 | * @param methodName the name of the invoked method
18 | * @param paramTypes the method's parameter types.
19 | * @param params the method's parameters
20 | * @return the object returned from the invoked method, if any
21 | * @throws Exception in case of invocation or invocation target exceptions
22 | */
23 | public Object invokeRemote(String methodName, Class[] paramTypes, Object[] params) throws Exception;
24 |
25 | }
26 |
--------------------------------------------------------------------------------
/src/com/interface21/remoting/rmi/RemoteInvocationWrapper.java:
--------------------------------------------------------------------------------
1 | package com.interface21.remoting.rmi;
2 |
3 | import java.lang.reflect.Method;
4 | import java.rmi.RemoteException;
5 | import java.rmi.server.UnicastRemoteObject;
6 |
7 | /**
8 | * Server-side implementation of RemoteInvocationHandler.
9 | * An instance of this class exists for each remote object.
10 | *
11 | * @author Juergen Hoeller
12 | * @since 14.05.2003
13 | */
14 | class RemoteInvocationWrapper extends UnicastRemoteObject implements RemoteInvocationHandler {
15 |
16 | private Object wrappedObject;
17 |
18 | /**
19 | * Create a new RemoteInvocationWrapper.
20 | * @param wrappedObject the locally wrapped object, on which methods are invoked
21 | */
22 | public RemoteInvocationWrapper(Object wrappedObject) throws RemoteException {
23 | super();
24 | this.wrappedObject = wrappedObject;
25 | }
26 |
27 | public Object invokeRemote(String methodName, Class[] paramTypes, Object[] params) throws Exception {
28 | Method method = wrappedObject.getClass().getMethod(methodName, paramTypes);
29 | return method.invoke(wrappedObject, params);
30 | }
31 |
32 | }
33 |
--------------------------------------------------------------------------------
/src/com/interface21/remoting/rmi/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Remoting classes for transparent RMI.
5 | Provides a proxy factory for accessing RMI services,
6 | and an exporter for making beans available for RMI clients.
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/src/com/interface21/remoting/support/AuthorizableRemoteProxyFactoryBean.java:
--------------------------------------------------------------------------------
1 | package com.interface21.remoting.support;
2 |
3 | /**
4 | * Abstract subclass of RemoteProxyFactoryBean,
5 | * adding support for authorization via username and password.
6 | * @author Juergen Hoeller
7 | * @since 13.05.2003
8 | */
9 | public abstract class AuthorizableRemoteProxyFactoryBean extends RemoteProxyFactoryBean {
10 |
11 | private String username;
12 |
13 | private String password;
14 |
15 | /**
16 | * Set the username that this factory should use to access the backend service.
17 | */
18 | public void setUsername(String username) {
19 | this.username = username;
20 | }
21 |
22 | protected String getUsername() {
23 | return username;
24 | }
25 |
26 | /**
27 | * Set the password that this factory should use to access the backend service.
28 | */
29 | public void setPassword(String password) {
30 | this.password = password;
31 | }
32 |
33 | protected String getPassword() {
34 | return password;
35 | }
36 |
37 | }
38 |
--------------------------------------------------------------------------------
/src/com/interface21/remoting/support/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Support classes for remoting implementations.
5 | Provides abstract base classes for remote proxy factories.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/CannotCreateTransactionException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.transaction;
7 |
8 | /**
9 | * Exception thrown when a transaction can't be created using an
10 | * underlying transaction API such as JTA.
11 | * @author Rod Johnson
12 | * @since 17-Mar-2003
13 | * @version $Revision$
14 | */
15 | public class CannotCreateTransactionException extends TransactionException {
16 |
17 | public CannotCreateTransactionException(String msg) {
18 | super(msg);
19 | }
20 |
21 | public CannotCreateTransactionException(String msg, Throwable ex) {
22 | super(msg, ex);
23 | }
24 |
25 | }
26 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/InvalidIsolationException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.transaction;
2 |
3 | /**
4 | * Exception that gets thrown when an invalid isolation level is specified,
5 | * i.e. an isolation level that the transaction manager implementation
6 | * doesn't support.
7 | * @author Juergen Hoeller
8 | * @since 12.05.2003
9 | */
10 | public class InvalidIsolationException extends TransactionUsageException {
11 |
12 | public InvalidIsolationException(String msg) {
13 | super(msg);
14 | }
15 |
16 | }
17 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/InvalidTimeoutException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.transaction;
2 |
3 | /**
4 | * Exception that gets thrown when an invalid timeout is specified,
5 | * i.e. the transaction manager implementation doesn't support timeouts.
6 | * @author Juergen Hoeller
7 | * @since 12.05.2003
8 | */
9 | public class InvalidTimeoutException extends TransactionUsageException {
10 |
11 | private int timeout = TransactionDefinition.TIMEOUT_DEFAULT;
12 |
13 | public InvalidTimeoutException(String msg, int timeout) {
14 | super(msg);
15 | this.timeout = timeout;
16 | }
17 |
18 | public int getTimeout() {
19 | return timeout;
20 | }
21 |
22 | }
23 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/NestedTransactionNotPermittedException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.transaction;
7 |
8 | /**
9 | * Exception thrown when an attempt is made to begin a transaction
10 | * but this would amount to a nested transaction, which is not
11 | * supporting by the underlying transaction implementation.
12 | * @author Rod Johnson
13 | * @since 17-Mar-2003
14 | * @version $Revision$
15 | */
16 | public class NestedTransactionNotPermittedException extends CannotCreateTransactionException {
17 |
18 | public NestedTransactionNotPermittedException(String msg) {
19 | super(msg);
20 | }
21 |
22 | public NestedTransactionNotPermittedException(String msg, Throwable ex) {
23 | super(msg, ex);
24 | }
25 |
26 | }
27 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/NoTransactionException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.transaction;
7 |
8 | /**
9 | * Exception thrown when an operation is attempted that
10 | * relies on an existing transaction (such as setting
11 | * rollback status) and there is no existing transaction.
12 | * This represents an illegal usage of the transaction API.
13 | * @author Rod Johnson
14 | * @since 17-Mar-2003
15 | * @version $Revision$
16 | */
17 | public class NoTransactionException extends TransactionUsageException {
18 |
19 | public NoTransactionException(String msg) {
20 | super(msg);
21 | }
22 |
23 | public NoTransactionException(String msg, Throwable ex) {
24 | super(msg, ex);
25 | }
26 |
27 | }
28 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/TransactionException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.transaction;
7 |
8 | import com.interface21.core.NestedRuntimeException;
9 |
10 | /**
11 | * Superclass for all transaction exceptions.
12 | * @author Rod Johnson
13 | * @since 17-Mar-2003
14 | * @version $Revision$
15 | */
16 | public abstract class TransactionException extends NestedRuntimeException {
17 |
18 | public TransactionException(String msg) {
19 | super(msg);
20 | }
21 |
22 | public TransactionException(String msg, Throwable ex) {
23 | super(msg, ex);
24 | }
25 |
26 | }
27 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/TransactionSystemException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.transaction;
2 |
3 | /**
4 | * Exception thrown when a general transaction system error is encountered,
5 | * like on commit or rollback.
6 | * @author Juergen Hoeller
7 | * @since 24.03.2003
8 | */
9 | public class TransactionSystemException extends TransactionException {
10 |
11 | public TransactionSystemException(String msg) {
12 | super(msg);
13 | }
14 |
15 | public TransactionSystemException(String msg, Throwable ex) {
16 | super(msg, ex);
17 | }
18 |
19 | }
20 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/TransactionUsageException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.transaction;
2 |
3 | /**
4 | * Superclass for exceptions caused by inappropriate usage of
5 | * a Spring transaction API.
6 | * @author Rod Johnson
7 | * @since 22-Mar-2003
8 | * @version $Revision$
9 | */
10 | public class TransactionUsageException extends TransactionException {
11 |
12 | public TransactionUsageException(String msg) {
13 | super(msg);
14 | }
15 |
16 | public TransactionUsageException(String msg, Throwable ex) {
17 | super(msg, ex);
18 | }
19 |
20 | }
21 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/UnexpectedRollbackException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.transaction;
7 |
8 | /**
9 | * Thrown when an attempt to commit a transaction resulted
10 | * in an unexpected rollback
11 | * @author Rod Johnson
12 | * @since 17-Mar-2003
13 | * @version $Revision$
14 | */
15 | public class UnexpectedRollbackException extends TransactionException {
16 |
17 | public UnexpectedRollbackException(String msg, Throwable ex) {
18 | super(msg, ex);
19 | }
20 |
21 | }
22 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/interceptor/DefaultTransactionAttribute.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.transaction.interceptor;
7 |
8 | import com.interface21.transaction.support.DefaultTransactionDefinition;
9 |
10 | /**
11 | * Transaction attribute that takes EJB approach to rolling
12 | * back on runtime, but not checked, exceptions.
13 | * @author Rod Johnson
14 | * @since 16-Mar-2003
15 | * @version $Id$
16 | */
17 | public class DefaultTransactionAttribute extends DefaultTransactionDefinition
18 | implements TransactionAttribute {
19 |
20 | public DefaultTransactionAttribute() {
21 | }
22 |
23 | public DefaultTransactionAttribute(int propagationBehavior) {
24 | super(propagationBehavior);
25 | }
26 |
27 | /**
28 | * Default behaviour is as with EJB: rollback on unchecked exception.
29 | * Consistent with TransactionTemplate's behavior.
30 | */
31 | public boolean rollbackOn(Throwable t) {
32 | return (t instanceof RuntimeException);
33 | }
34 |
35 | }
36 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/interceptor/NoRollbackRuleAttribute.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.transaction.interceptor;
7 |
8 | /**
9 | * Tag class. Its class means it has the opposite
10 | * behaviour to the RollbackRule superclass.
11 | * @author Rod Johnson
12 | * @since 09-Apr-2003
13 | * @version $Revision$
14 | */
15 | public class NoRollbackRuleAttribute extends RollbackRuleAttribute {
16 |
17 | /**
18 | * @param exceptionName
19 | */
20 | public NoRollbackRuleAttribute(String exceptionName) {
21 | super(exceptionName);
22 | }
23 |
24 | }
25 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/interceptor/TransactionAttribute.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.transaction.interceptor;
7 |
8 | import com.interface21.transaction.TransactionDefinition;
9 |
10 | /**
11 | * This interface adds a rollBackOn specification to TransactionDefinition.
12 | * As custom rollBackOn is only possible with AOP, this class resides
13 | * in the AOP transaction package.
14 | *
15 | * @author Rod Johnson
16 | * @since 16-Mar-2003
17 | * @version $Revision$
18 | * @see com.interface21.transaction.interceptor.DefaultTransactionAttribute
19 | */
20 | public interface TransactionAttribute extends TransactionDefinition {
21 |
22 | /**
23 | * Should we roll back on a checked exception?
24 | * @param ex the exception to evaluate
25 | * @return boolean rollback or not
26 | */
27 | boolean rollbackOn(Throwable ex);
28 |
29 | }
30 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/interceptor/TransactionAttributeSource.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.transaction.interceptor;
7 |
8 | import org.aopalliance.intercept.MethodInvocation;
9 |
10 | /**
11 | * Interface used by TransactionInterceptor. Implementations know
12 | * how to source transaction attributes, whether from configuration,
13 | * metadata attributes at source level, or anywhere else.
14 | * @author Rod Johnson
15 | * @since 15-Apr-2003
16 | * @version $Id$
17 | */
18 | public interface TransactionAttributeSource {
19 |
20 | /**
21 | * Return the transaction attribute for this method.
22 | * Return null if the method is non-transactional.
23 | * @param invocation method invocation descriptor
24 | * @return TransactionAttribute transaction attribute or null.
25 | */
26 | TransactionAttribute getTransactionAttribute(MethodInvocation invocation);
27 |
28 | }
29 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/interceptor/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | AOP-based solution for declarative transaction demarcation.
5 | Builds on the AOP infrastructure in com.interface21.aop.framework.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/jta/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Transaction SPI implementation for JTA.
5 |
6 |
7 |
8 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Exception hierarchy for Spring's transaction infrastructure,
5 | independent of any specific transaction management system.
6 | Contains transaction manager, definition, and status interfaces.
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/support/TransactionSynchronization.java:
--------------------------------------------------------------------------------
1 | package com.interface21.transaction.support;
2 |
3 | /**
4 | * Interface for callbacks after transaction completion.
5 | * Supported by AbstractPlatformTransactionManager.
6 | * @author Juergen Hoeller
7 | * @since 02.06.2003
8 | * @see TransactionSynchronizationManager
9 | * @see AbstractPlatformTransactionManager
10 | */
11 | public interface TransactionSynchronization {
12 |
13 | /**
14 | * Completion status in case of proper commit
15 | */
16 | int STATUS_COMMITTED = 0;
17 |
18 | /**
19 | * Completion status in case of proper rollback
20 | */
21 | int STATUS_ROLLED_BACK = 1;
22 |
23 | /**
24 | * Status in case of heuristic mixed completion or system errors
25 | */
26 | int STATUS_UNKNOWN = 2;
27 |
28 | /**
29 | * Invoked after transaction completion.
30 | * Can e.g. perform proper resource cleanup.
31 | * @param status completion status according to the STATUS_ constants
32 | */
33 | void afterCompletion(int status);
34 |
35 | }
36 |
--------------------------------------------------------------------------------
/src/com/interface21/transaction/support/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Support classes for the com.interface21.transaction package.
5 | Provides an abstract base class for transaction manager implementations,
6 | and a template plus callback for transaction demarcation.
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/src/com/interface21/ui/context/NestingThemeSource.java:
--------------------------------------------------------------------------------
1 | package com.interface21.ui.context;
2 |
3 | /**
4 | * Subinterface of ThemeSource to be implemented by objects that
5 | * can resolve messages hierarchically.
6 | * @author Rod Johnson
7 | * @author Jean-Pierre Pawlak
8 | * @version $RevisionId$
9 | */
10 | public interface NestingThemeSource extends ThemeSource {
11 |
12 | /**
13 | * Set the parent that will be used to try to resolve theme messages
14 | * that this object can't resolve.
15 | * @param parent parent ThemeSource that will be used to
16 | * resolve messages that this object can't resolve.
17 | * May be null, in which case no further resolution is possible.
18 | */
19 | void setParent(ThemeSource parent);
20 | }
21 |
22 |
--------------------------------------------------------------------------------
/src/com/interface21/ui/context/Theme.java:
--------------------------------------------------------------------------------
1 | package com.interface21.ui.context;
2 |
3 | import com.interface21.context.MessageSource;
4 |
5 | /**
6 | * A Theme can resolve theme-specific messages, codes, file paths, etc
7 | * (e.g. CSS and image files in a web environment).
8 | * The MessageSource supports parameterization and internationalization.
9 | * @author Juergen Hoeller
10 | * @since 17.06.2003
11 | * @see ThemeSource
12 | * @see com.interface21.web.servlet.theme
13 | */
14 | public interface Theme {
15 |
16 | /**
17 | * Return the name of the theme.
18 | * @return the name of the theme
19 | */
20 | String getName();
21 |
22 | /**
23 | * Return the specific MessageSource that resolves messages
24 | * with respect to this theme.
25 | * @return the theme-specific MessageSource
26 | */
27 | MessageSource getMessageSource();
28 |
29 | }
30 |
--------------------------------------------------------------------------------
/src/com/interface21/ui/context/ThemeSource.java:
--------------------------------------------------------------------------------
1 | package com.interface21.ui.context;
2 |
3 | /**
4 | * Interface to be implemented by objects that can resolve Themes.
5 | * This enables parameterization and internationalization of messages
6 | * for a given theme.
7 | * @author Jean-Pierre Pawlak
8 | * @author Juergen Hoeller
9 | * @see Theme
10 | */
11 | public interface ThemeSource {
12 |
13 | /**
14 | * Return the Theme instance for the given theme name.
15 | * The returned Theme will resolve theme-specific messages, codes,
16 | * file paths, etc (e.g. CSS and image files in a web environment).
17 | * @param themeName name of the theme
18 | * @return the respective Theme, or null if none defined
19 | */
20 | Theme getTheme(String themeName);
21 |
22 | }
23 |
--------------------------------------------------------------------------------
/src/com/interface21/ui/context/support/SimpleTheme.java:
--------------------------------------------------------------------------------
1 | package com.interface21.ui.context.support;
2 |
3 | import com.interface21.ui.context.Theme;
4 | import com.interface21.context.MessageSource;
5 |
6 | /**
7 | * Default Theme implementation, wrapping a name and an
8 | * underlying MessageSource.
9 | * @author Juergen Hoeller
10 | * @since 17.06.2003
11 | */
12 | public class SimpleTheme implements Theme {
13 |
14 | private String name;
15 |
16 | private MessageSource messageSource;
17 |
18 | public SimpleTheme(String name, MessageSource messageSource) {
19 | this.name = name;
20 | this.messageSource = messageSource;
21 | }
22 |
23 | public String getName() {
24 | return name;
25 | }
26 |
27 | public MessageSource getMessageSource() {
28 | return messageSource;
29 | }
30 |
31 | }
32 |
--------------------------------------------------------------------------------
/src/com/interface21/ui/context/support/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Classes supporting the com.interface21.ui.context package.
5 | Provides base classes for specialized UI contexts, e.g. for web UIs.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/util/ConstantException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * The Spring Framework is published under the terms
3 | * of the Apache Software License.
4 | */
5 |
6 | package com.interface21.util;
7 |
8 | /**
9 | * Exception thrown when the Constants class is asked for an invalid
10 | * constant name.
11 | * @see com.interface21.util.Constants
12 | * @version $Id$
13 | * @author Rod Johnson
14 | * @since 28-Apr-2003
15 | */
16 | public class ConstantException extends IllegalArgumentException {
17 |
18 | /**
19 | * Thrown when an invalid constant name is requested
20 | * @param field invalid constant name
21 | * @param clazz class containing the constant definitions
22 | * @param message description of the problem
23 | */
24 | public ConstantException(String field, Class clazz, String message) {
25 | super("Field '" + field + "' " + message + " in " + clazz);
26 | }
27 |
28 | }
29 |
--------------------------------------------------------------------------------
/src/com/interface21/util/PagedListSourceProvider.java:
--------------------------------------------------------------------------------
1 | package com.interface21.util;
2 |
3 | import java.util.List;
4 | import java.util.Locale;
5 |
6 | /**
7 | * Callback that provides the source for a reloadable List.
8 | * Used by RefreshablePagedListHolder.
9 | * @author Jean-Pierre PAWLAK
10 | * @author Juergen Hoeller
11 | * @see RefreshablePagedListHolder#setSourceProvider
12 | */
13 | public interface PagedListSourceProvider {
14 |
15 | /**
16 | * Load the List for the given Locale and filter settings.
17 | * The filter object can be of any custom class, preferably a bean
18 | * for easy data binding from a request. An instance will simply
19 | * get passed through to this callback method.
20 | * @param locale Locale that the List should be loaded for,
21 | * or null if not locale-specific
22 | * @param filter object representing filter settings,
23 | * or null if no filter options are used
24 | * @return the loaded List
25 | * @see RefreshablePagedListHolder#setLocale
26 | * @see RefreshablePagedListHolder#setFilter
27 | */
28 | public List loadList(Locale locale, Object filter);
29 |
30 | }
31 |
--------------------------------------------------------------------------------
/src/com/interface21/util/package.html:
--------------------------------------------------------------------------------
1 |
Miscellaneous utility classes, such as String manipulation utilities,
a Log4J configurer, and a state holder for paged lists of objects.
--------------------------------------------------------------------------------
/src/com/interface21/validation/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Provides data binding and validation functionality,
5 | for usage in business and/or UI layers.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/web/bind/ServletRequestBindingException.java:
--------------------------------------------------------------------------------
1 |
2 | package com.interface21.web.bind;
3 |
4 | import javax.servlet.ServletException;
5 |
6 |
7 | /**
8 | * Fatal binding exception, thrown when we want to
9 | * treat binding exceptions as unrecoverable.
10 | * @author Rod Johnson
11 | */
12 | public class ServletRequestBindingException extends ServletException {
13 |
14 | public ServletRequestBindingException(String s) {
15 | super(s);
16 | }
17 |
18 | public ServletRequestBindingException(String s, Throwable t) {
19 | super(s, t);
20 | }
21 |
22 | }
23 |
--------------------------------------------------------------------------------
/src/com/interface21/web/bind/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Provides web-specific data binding functionality, including a
5 | utility class for easy invocation of binding and validation.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/web/context/ContextLoaderListener.java:
--------------------------------------------------------------------------------
1 | package com.interface21.web.context;
2 |
3 | import javax.servlet.ServletContextEvent;
4 | import javax.servlet.ServletContextListener;
5 |
6 | /**
7 | * Bootstrap listener to start up Spring's root WebApplicationContext.
8 | * Simply delegates to ContextLoader.
9 | *
10 | *
Note: This listener should be registered after Log4jConfigListener,
11 | * if the latter is used.
12 | *
13 | * @author Juergen Hoeller
14 | * @since 17.02.2003
15 | * @see ContextLoader
16 | * @see com.interface21.web.util.Log4jConfigListener
17 | */
18 | public class ContextLoaderListener implements ServletContextListener {
19 |
20 | /**
21 | * Initialize the root web application context.
22 | */
23 | public void contextInitialized(ServletContextEvent event) {
24 | ContextLoader.initContext(event.getServletContext());
25 | }
26 |
27 | /**
28 | * Close the root web application context.
29 | */
30 | public void contextDestroyed(ServletContextEvent event) {
31 | ContextLoader.closeContext(event.getServletContext());
32 | }
33 |
34 | }
35 |
--------------------------------------------------------------------------------
/src/com/interface21/web/context/package.html:
--------------------------------------------------------------------------------
1 |
Contains the application context subinterface for web applications,
and the ContextLoaderListener that bootstraps the root web
application context.
--------------------------------------------------------------------------------
/src/com/interface21/web/context/support/package.html:
--------------------------------------------------------------------------------
1 |
Classes supporting the com.interface21.web.context package,
such as WebApplicationContext implementations, and a utility
class for retrieval of the root application context etc.
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/handler/UrlAwareHandler.java:
--------------------------------------------------------------------------------
1 | package com.interface21.web.servlet.handler;
2 |
3 | /**
4 | * Optional interface to be implemented by request handlers in our
5 | * MVC approach that are interested in the URL they are mapped to.
6 | * @author Rod Johnson
7 | */
8 | public interface UrlAwareHandler {
9 |
10 | /**
11 | * Set the URL this handler is mapped to.
12 | * This interface will only be implemented by some handlers:
13 | * others may be mapped to many URLs, and so cannot
14 | * benefit from knowledge of individual mappings.
15 | * Of course a handler can find out the request URL when it handles
16 | * a request: implementations of this interface want to know
17 | * about a single URL mapping before they begin to handle
18 | * requests.
19 | * @param url the URL this handler is mapped to
20 | */
21 | void setUrlMapping(String url);
22 |
23 | }
24 |
25 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/handler/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Provides standard HandlerMapping implementations,
5 | including abstract base classes for custom implementations.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/i18n/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Locale support classes for Spring's web MVC framework.
5 | Provides standard LocaleResolver implementations,
6 | and a HandlerInterceptor for locale changes.
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/mvc/multiaction/NoSuchRequestHandlingMethodException.java:
--------------------------------------------------------------------------------
1 | package com.interface21.web.servlet.mvc.multiaction;
2 |
3 | import javax.servlet.http.HttpServletRequest;
4 | import javax.servlet.ServletException;
5 |
6 | /**
7 | * Exception thrown when there's no request handling method for
8 | * this request.
9 | * @author Rod Johnson
10 | */
11 | public class NoSuchRequestHandlingMethodException extends ServletException {
12 |
13 | private String name;
14 |
15 | public NoSuchRequestHandlingMethodException(HttpServletRequest request) {
16 | super("No handling method can be found for request [" + request + "]");
17 | }
18 |
19 | public NoSuchRequestHandlingMethodException(String name, MultiActionController multiActionRequestController) {
20 | super(
21 | "No request handling method with name '" + name + "' in class " + multiActionRequestController.getClass().getName());
22 | this.name = name;
23 | }
24 |
25 | public String getName() {
26 | return name;
27 | }
28 |
29 | }
30 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/package.html:
--------------------------------------------------------------------------------
1 |
Provides servlets that integrate with the application context
infrastructure, and the core interfaces and classes for the
Spring web MVC framework.
This package and related packages are discussed in Chapters 12 and 13 of
Expert One-On-One J2EE Design and Development
by Rod Johnson (Wrox, 2002).
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/support/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Support classes for Spring's web MVC framework.
5 | Provides easy evaluation of the request context in views,
6 | and miscellaneous HandlerInterceptor implementations.
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/tags/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Spring's standard custom tag library.
5 | Supports JSP view implementations for Spring's web MVC framework.
6 | See i21.tld for descriptions of the various tags.
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/theme/FixedThemeResolver.java:
--------------------------------------------------------------------------------
1 | package com.interface21.web.servlet.theme;
2 |
3 | import javax.servlet.http.HttpServletRequest;
4 | import javax.servlet.http.HttpServletResponse;
5 |
6 |
7 | /**
8 | * Implementation of ThemeResolver that simply uses a fixed theme.
9 | * The fixed name can be defined via the defaultTheme property.
10 | *
11 | *
Note: Does not support setThemeName, as the theme is fixed.
12 | *
13 | * @author Jean-Pierre Pawlak
14 | * @author Juergen Hoeller
15 | * @since 17.06.2003
16 | * @see #setDefaultThemeName
17 | */
18 | public class FixedThemeResolver extends AbstractThemeResolver {
19 |
20 | public String resolveThemeName(HttpServletRequest request) {
21 | return getDefaultThemeName();
22 | }
23 |
24 | public void setThemeName(HttpServletRequest request, HttpServletResponse response, String themeName) {
25 | throw new IllegalArgumentException("Cannot change theme - use a different theme resolution strategy");
26 | }
27 |
28 | }
29 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/view/document/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Support classes for document generation,
5 | providing View implementations for PDF and Excel.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/view/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Provides standard View and ViewResolver implementations,
5 | including abstract base classes for custom implementations.
6 |
7 |
Application developers don't usually need to implement views,
8 | as the framework provides standard views for JSPs, Velocity,
9 | XSLT, etc. However, the ability to implement custom views easily
10 | by subclassing the AbstractView class in this package can be
11 | very helpful if an application has unusual view requirements.
12 |
13 |
14 |
15 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/view/velocity/CommonsLoggingLogSystem.java:
--------------------------------------------------------------------------------
1 | package com.interface21.web.servlet.view.velocity;
2 |
3 | import org.apache.commons.logging.Log;
4 | import org.apache.commons.logging.LogFactory;
5 | import org.apache.velocity.runtime.RuntimeServices;
6 | import org.apache.velocity.runtime.log.LogSystem;
7 |
8 | /**
9 | * Velocity LogSystem implementation for Jakarta Commons Logging.
10 | * Used by VelocityConfigurer to redirect log output.
11 | * @author Juergen Hoeller
12 | * @since 07.08.2003
13 | * @see VelocityConfigurer
14 | */
15 | public class CommonsLoggingLogSystem implements LogSystem {
16 |
17 | private Log logger = LogFactory.getLog(getClass());
18 |
19 | public void init(RuntimeServices runtimeServices) {
20 | }
21 |
22 | public void logVelocityMessage(int i, String msg) {
23 | switch (i) {
24 | case ERROR_ID:
25 | logger.error(msg);
26 | break;
27 | case WARN_ID:
28 | logger.warn(msg);
29 | break;
30 | case INFO_ID:
31 | logger.info(msg);
32 | break;
33 | case DEBUG_ID:
34 | logger.debug(msg);
35 | break;
36 | }
37 | }
38 |
39 | }
40 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/view/velocity/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Support classes for Velocity,
5 | providing a View implementation for Velocity templates
6 | and a Velocity initialization bean.
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/src/com/interface21/web/servlet/view/xslt/package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Support classes for XSLT,
5 | providing a View implementation for XSLT stylesheets.
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/src/com/interface21/web/util/HtmlUtils.java:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/cbeams/spring-framework-i21/ed27de6d3e2246b2e6d7538e1fe7f7226d11ec3d/src/com/interface21/web/util/HtmlUtils.java
--------------------------------------------------------------------------------
/src/com/interface21/web/util/Log4jConfigListener.java:
--------------------------------------------------------------------------------
1 | package com.interface21.web.util;
2 |
3 | import javax.servlet.ServletContextEvent;
4 | import javax.servlet.ServletContextListener;
5 |
6 | /**
7 | * Bootstrap listener for custom Log4J initialization in a web environment.
8 | * Simply delegates to Log4jWebConfigurer.
9 | *
10 | *
Note: This listener should be placed before ContextLoaderListener
11 | * in web.xml, when using custom Log4J initialization.
12 | *
13 | * @author Juergen Hoeller
14 | * @since 13.03.2003
15 | * @see com.interface21.web.util.Log4jWebConfigurer
16 | * @see WebAppRootListener
17 | */
18 | public class Log4jConfigListener implements ServletContextListener {
19 |
20 | public void contextInitialized(ServletContextEvent event) {
21 | Log4jWebConfigurer.initLogging(event.getServletContext());
22 | }
23 |
24 | public void contextDestroyed(ServletContextEvent event) {
25 | Log4jWebConfigurer.shutdownLogging(event.getServletContext());
26 | }
27 |
28 | }
29 |
--------------------------------------------------------------------------------
/src/com/interface21/web/util/package.html:
--------------------------------------------------------------------------------
1 |
2 |
14 | This document should (probably) provide an overview of the problem domains Spring
15 | tackles and a brief explanation of the approach taken in each case and why it is
16 | superior to conventional development practices.
17 |
12 | Spring's main goal is to provide a framework which simplifies the development of J2EE
13 | applications. To achieve this it addresses issues such as:
14 |
14 | Spring is a framework for developing J2EE applications. It is based on the code published in the book
15 | Expert One-on-One J2EE Design and Development written by
16 | Rod Johnson. It includes code for JavaBeans-based configuration management and a JDBC abstraction layer.
17 |
" alt="gen.back"/>
10 |