当前页面: 在线文档首页 > Spring Framework 1.2.9 API 文档英文版

SingleConnectionFactory (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

Overview  Package   Class  Use  Tree  Deprecated  Index  Help
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.springframework.jca.cci.connection
Class SingleConnectionFactory

java.lang.Object
  org.springframework.jca.cci.connection.DelegatingConnectionFactory
      org.springframework.jca.cci.connection.SingleConnectionFactory

All Implemented Interfaces:

Serializable, Referenceable, ConnectionFactory, DisposableBean, InitializingBean

---

public class SingleConnectionFactory
extends DelegatingConnectionFactory
implements DisposableBean

A CCI ConnectionFactory adapter that returns the same Connection on all getConnection calls, and ignores calls to Connection.close().

Useful for testing and standalone environments, to keep using the same Connection for multiple CciTemplate calls, without having a pooling ConnectionFactory, also spanning any number of transactions.

You can either pass in a CCI Connection directly, or let this factory lazily create a Connection via a given target ConnectionFactory.

Since:

1.2

Author:

Juergen Hoeller

See Also:

getConnection(), Connection.close(), CciTemplate, Serialized Form

---

Field Summary
protected  Log	logger

 

Constructor Summary
SingleConnectionFactory()           Create a new SingleConnectionFactory for bean-style usage.
SingleConnectionFactory(Connection target)           Create a new SingleConnectionFactory that always returns the given Connection.
SingleConnectionFactory(ConnectionFactory targetConnectionFactory)           Create a new SingleConnectionFactory that always returns a single Connection that it will lazily create via the given target ConnectionFactory.

 

Method Summary
void	afterPropertiesSet()           Make sure a Connection or ConnectionFactory has been set.
void	destroy()           Close the underlying connection.
protected  Connection	doCreateConnection()           Create a CCI Connection via this template's ConnectionFactory.
protected  Connection	getCloseSuppressingConnectionProxy(Connection target)           Wrap the given Connection with a proxy that delegates every method call to it but suppresses close calls.
Connection	getConnection()
Connection	getConnection(ConnectionSpec connectionSpec)
protected  void	init()           Initialize the single Connection.

 

Methods inherited from class org.springframework.jca.cci.connection.DelegatingConnectionFactory
getMetaData, getRecordFactory, getReference, getTargetConnectionFactory, setReference, setTargetConnectionFactory

 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Field Detail

logger

protected final Log logger

Constructor Detail

SingleConnectionFactory

public SingleConnectionFactory()

Create a new SingleConnectionFactory for bean-style usage.

See Also:

DelegatingConnectionFactory.setTargetConnectionFactory(javax.resource.cci.ConnectionFactory)

---

SingleConnectionFactory

public SingleConnectionFactory(Connection target)

Create a new SingleConnectionFactory that always returns the given Connection.

Parameters:

target - the single Connection

---

SingleConnectionFactory

public SingleConnectionFactory(ConnectionFactory targetConnectionFactory)

Create a new SingleConnectionFactory that always returns a single Connection that it will lazily create via the given target ConnectionFactory.

Parameters:

targetConnectionFactory - the target ConnectionFactory

Method Detail

afterPropertiesSet

public void afterPropertiesSet()

Make sure a Connection or ConnectionFactory has been set.

Specified by:

afterPropertiesSet in interface InitializingBean

Overrides:

afterPropertiesSet in class DelegatingConnectionFactory

---

init

protected void init()
             throws ResourceException

Initialize the single Connection.

Throws:

ResourceException - if thrown by CCI API methods

---

doCreateConnection

protected Connection doCreateConnection()
                                 throws ResourceException

Create a CCI Connection via this template's ConnectionFactory.

Returns:

the new CCI Connection

Throws:

ResourceException - if thrown by CCI API methods

---

destroy

public void destroy()
             throws ResourceException

Close the underlying connection. The provider of this ConnectionFactory needs to care for proper shutdown.

As this bean implements DisposableBean, a bean factory will automatically invoke this on destruction of its cached singletons.

Specified by:

destroy in interface DisposableBean

Throws:

ResourceException

---

getConnection

public Connection getConnection()
                         throws ResourceException

Specified by:

getConnection in interface ConnectionFactory

Overrides:

getConnection in class DelegatingConnectionFactory

Throws:

ResourceException

---

getConnection

public Connection getConnection(ConnectionSpec connectionSpec)
                         throws ResourceException

Specified by:

getConnection in interface ConnectionFactory

Overrides:

getConnection in class DelegatingConnectionFactory

Throws:

ResourceException

---

getCloseSuppressingConnectionProxy

protected Connection getCloseSuppressingConnectionProxy(Connection target)

Wrap the given Connection with a proxy that delegates every method call to it but suppresses close calls. This is useful for allowing application code to handle a special framework Connection just like an ordinary Connection from a CCI ConnectionFactory.

Parameters:

target - the original Connection to wrap

Returns:

the wrapped Connection

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Copyright (c) 2002-2007 The Spring Framework Project.