|
|||||||||
ÀüÀÇ Å¬·¡½º ´ÙÀ½ÀÇ Å¬·¡½º | ÇÁ·¹ÀÓ ÀÖ¾î ÇÁ·¹ÀÓ ¾øÀ½ | ||||||||
°³¿ä: ³»ºÎ Ŭ·¡½º | Çʵå | constructor¡¡ ¡¡ | ¸Þ¼Òµå | »ó¼¼: Çʵå | constructor¡¡ ¡¡ | ¸Þ¼Òµå |
ManagedConnection ÀνºÅϽº´Â, ¹èÈÄÀÇ EIS ¿¡ÀÇ ¹°¸® Á¢¼ÓÀ» ³ªÅ¸³À´Ï´Ù.
ManagedConnection ÀνºÅϽº´Â,javax.transaction.xa.XAResource
¹× javax.resource.spi.LocalTransaction
¶ó°í ÇÏ´Â, ÀÎÅÍÆäÀ̽ºÀÇ Æä¾î¿¡ÀÇ ¾×¼¼½º¸¦ Á¦°øÇÕ´Ï´Ù.
XAResource
ÀÎÅÍÆäÀ̽º´Â, Æ®·£Àè¼Ç(transaction) ¸Å´ÏÀú°¡ Æ®·£Àè¼Ç(transaction)¿Í ¹èÈÄÀÇ EIS ¸®¼Ò½º ¸Å´ÏÀú ÀνºÅϽº¿ÍÀÇ °ü·ÃÁþ°í ¹× °ü·ÃÁþ°íÀÇ ÇØÁ¦¸¦ ½Ç½ÃÇϰųª 2 ´Ü°è À§Å¹ ÇÁ·ÎÅäÄÝÀ» ½ÇÇàÇϰųª Çϱâ À§Çؼ »ç¿ëµË´Ï´Ù. ManagedConnection ÀÎÅÍÆäÀ̽º´Â, Æ®·£Àè¼Ç(transaction) ¸Å´ÏÀú·ÎºÎÅÍ Á÷Á¢ »ç¿ëµÇÁö ¾Ê½À´Ï´Ù. XAResource ÀÎÅÍÆäÀ̽ºÀÇ ÀÚ¼¼ÇÑ °ÍÀº, JTA »ç¾ç¿¡ ±â¼úµÇ°í ÀÖ½À´Ï´Ù.
LocalTransaction ÀÎÅÍÆäÀ̽º´Â, ¾îÇø®ÄÉÀÌ¼Ç ¼¹ö°¡ ·ÎÄà Ʈ·£Àè¼Ç(transaction)¸¦ °ü¸®Çϱâ À§Çؼ »ç¿ëµË´Ï´Ù.
ManagedConnectionFactory
,
XAResource
,
LocalTransaction
¸Þ¼ÒµåÀÇ °³¿ä | |
void |
addConnectionEventListener (ConnectionEventListener listener)
Á¢¼Ó À̺¥Æ® ûÃëÀÚ¸¦ ManagedConnection ÀνºÅϽº¿¡ Ãß°¡ÇÕ´Ï´Ù. |
void |
associateConnection (java.lang.Object connection)
ÄÁÅ×À̳ʰ¡, ¾îÇø®ÄÉÀÌ¼Ç ·¹º§ÀÇ Á¢¼Ó ÇÚµé°ú ManagedConneciton ÀνºÅϽº¿ÍÀÇ °ü·ÃÁþ°í¸¦ º¯°æÇϱâ À§Çؼ »ç¿ëµË´Ï´Ù. |
void |
cleanup ()
¾îÇø®ÄÉÀÌ¼Ç ¼¹ö´Â ÀÌ ¸Þ¼Òµå¸¦ È£ÃâÇØ, ManagedConnection ÀνºÅϽº»óÀÇ ¸ðµç Ŭ¸° ¾÷À» °Á¦ ½ÇÇàÇÕ´Ï´Ù. |
void |
destroy ()
¹èÈÄÀÇ ¸®¼Ò½º ¸Å´ÏÀú¿¡ÀÇ ¹°¸® Á¢¼ÓÀ» ÆÄ±âÇÕ´Ï´Ù. |
java.lang.Object |
getConnection (Subject subject,
ConnectionRequestInfo cxRequestInfo)
ManagedConnection ÀνºÅϽº¿¡ ÀÇÇØ ³ªÅ¸³»Áö´Â, ¹èÈÄÀÇ ¹°¸® Á¢¼ÓÀÇ »õ·Î¿î Á¢¼Ó ÇÚµéÀ» ÀÛ¼ºÇÕ´Ï´Ù. |
LocalTransaction |
getLocalTransaction ()
javax.resource.spi.LocalTransaction ÀνºÅϽº¸¦ µ¹·ÁÁÝ´Ï´Ù. |
java.io.PrintWriter |
getLogWriter ()
ÀÌ ManagedConnection ÀνºÅϽº¿¡ ´ëÇÑ ·Î±× ¶óÀÌÅ͸¦ ÃëµæÇÕ´Ï´Ù. |
ManagedConnectionMetaData |
getMetaData ()
ÀÌ Á¢¼ÓÀÇ ¹èÈÄÀÇ EIS ¸®¼Ò½º ¸Å´ÏÀú ÀνºÅϽº¿¡ ´ëÇÑ ¸ÞŸµ¥ÀÌŸ Á¤º¸¸¦ ÃëµæÇÕ´Ï´Ù. |
XAResource |
getXAResource ()
javax.transaction.xa.XAresource ÀνºÅϽº¸¦ µ¹·ÁÁÝ´Ï´Ù. |
void |
removeConnectionEventListener (ConnectionEventListener listener)
¹ú½á µî·ÏÀ» ¸¶Ä£ Á¢¼Ó À̺¥Æ® ûÃëÀÚ¸¦, ManagedConnection ÀνºÅϽº·ÎºÎÅÍ »èÁ¦ÇÕ´Ï´Ù. |
void |
setLogWriter (java.io.PrintWriter out)
ÀÌ ManagedConnection ÀνºÅϽº¿¡ ´ëÇÑ ·Î±× ¶óÀÌÅ͸¦ ¼³Á¤ÇÕ´Ï´Ù. |
¸Þ¼ÒµåÀÇ »ó¼¼ |
public java.lang.Object getConnection(Subject subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException
ManagedConnection ´Â Subject ¿Í Ãß°¡ÀÇ ConnectionRequest Info (¸®¼Ò½º ¾î´ðÅÍ¿¡ °íÀ¯ÇØ, ¾îÇø®ÄÉÀÌ¼Ç ¼¹ö¿¡´Â ¼û°ÜÁ® ÀÖ´Ù)¸¦ »ç¿ëÇØ, ¹°¸® Á¢¼Ó »óŸ¦ ¼³Á¤ÇÕ´Ï´Ù.
subject
- JAAS Subject·Î¼ÀÇ ½ÃÅ¥·¯Æ¼ ¹®¸ÆcxRequestInfo
- ConnectionRequestInfo ÀνºÅϽºResourceException
- Á¶ÀÛÀÌ ½ÇÆÐÇßÀ» °æ¿ì´Â ¹ü¿ëÀûÀÎ ¿¹¿ÜResourceAdapterInternalException
- ¸®¼Ò½º ¾î´ðÅÍ ³»ºÎ ¿¡·¯ »óÅÂSecurityException
- ½ÃÅ¥·¯Æ¼ °ü·Ã ¿¡·¯ »óÅÂCommException
- EIS ÀνºÅϽº¿ÍÀÇ Åë½Å¿¡ ÀåÇØ°¡ ¹ß»ýÇßÀ» °æ¿ìEISSystemException
- EIS ÀνºÅϽº¿¡ ÀÖ¾î¼ÀÇ ³»ºÎ ¿¡·¯ »óÅÂ. EIS ÀνºÅϽº°¡ ManagedConnection »óÅ ¼³Á¤¿¡ °ü°èÇÏ´Â °æ¿ì¿¡ »ç¿ëµÈ´Ùpublic void destroy() throws ResourceException
Á¢¼Ó Ç®ÀÇ »çÀÌÁ °ü¸®Çϱâ À§Çؼ, ¾îÇø®ÄÉÀÌ¼Ç ¼¹ö´Â ¸í½ÃÀûÀ¸·Î ManagedConnection.destroy ¸¦ È£ÃâÇØ, ¹°¸® Á¢¼ÓÀ» ÆÄ±âÇÒ ¼ö°¡ ÀÖ½À´Ï´Ù. ÆÄ±â ¸Þ¼Òµå°¡ ºÒ·Á °¡¸é(ÀÚ), ¸®¼Ò½º ¾î´ðÅÍ´Â ÀÌ ManagedConnection ÀνºÅϽº¿¡ ÇÒ´ç¸ðµç system resource¸¦ ÆÄ±âÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù.
ResourceException
- Á¶ÀÛÀÌ ½ÇÆÐÇßÀ» °æ¿ì´Â ¹ü¿ëÀûÀÎ ¿¹¿ÜIllegalStateException
- ÆÄ±âÇÏ´Â Á¢¼Ó¿¡ ´ëÇÑ ºÎÁ¤ÇÑ »óÅÂpublic void cleanup() throws ResourceException
ManagedConnection.cleanup ¸Þ¼Òµå´Â, ManagedConnection ÀνºÅϽº¿¡ ÀÇÇØ À¯Áö ¶°³¯ ¼ö ÀÖ¾î ¸ðµç Ŭ¶óÀÌ¾ðÆ® °íÀ¯ »óÅÂÀÇ Å¬¸° ¾÷À» °³½ÃÇÕ´Ï´Ù. Ŭ¸° ¾÷¿¡ ÀÇÇØ, ÀÌ ManagedConnection ÀνºÅϽº¸¦ »ç¿ëÇØ ÀÛ¼ºµÈ ¸ðµç Á¢¼Ó ÇÚµéÀº ¹«È¿°¡ µË´Ï´Ù. ¹èÈÄÀÇ ManagedConnection ÀÇ Å¬¸° ¾÷ ÈÄ, ¾îÇø®ÄÉÀÌ¼Ç ÄÄÆÛ³ÍÆ®°¡ Á¢¼Ó ÇÚµéÀÇ »ç¿ëÀ» ½ÃµµÇϸé(ÀÚ) ¿¹¿Ü°¡ ¹ß»ýÇÕ´Ï´Ù.
ManagedConnection ÀÇ Å¬¸° ¾÷Àº, Ç×»ó ¾îÇø®ÄÉÀÌ¼Ç ¼¹ö¿¡ ÀÇÇØ Á¦¾îµË´Ï´Ù. ÁøÇàÁßÀÇ Á¾·áÇϰí ÀÖÁö ¾Ê´Â Æ®·£Àè¼Ç(transaction) (ManagedConnection ÀνºÅϽº¿¡ °ü·ÃÇÑ´Ù)°¡ Á¸ÀçÇÒ ¶§, ¾îÇø®ÄÉÀÌ¼Ç ¼¹ö´Â ManagedConnection.cleanup ¸¦ È£ÃâÇØ µÇÁö ¾Ê½À´Ï´Ù.
¹ú½á Ŭ¸° ¾÷ ³¡³ Á¢¼Ó»ó¿¡¼ ManagedConnection.cleanup ¸Þ¼Òµå¸¦ È£ÃâÇØµµ, ¿¹¿Ü¸¦ ½½·Î¿ì ÇØ¼´Â ¾ÈµË´Ï´Ù.
ManagedConnection ÀνºÅϽºÀÇ Å¬¸° ¾÷Àº Ŭ¶óÀÌ¾ðÆ® °íÀ¯ »óŸ¦ ¸®¼ÂÆ® ÇØ, Á¢¼ÓÀ» Á¢¼Ó Ç®¿¡ µÇµ¹¸± Áغñ¸¦ ÇÕ´Ï´Ù. ÀÌ Å¬¸° ¾÷ ¸Þ¼Òµå¿¡ ÀÇÇØ, ¸®¼Ò½º ¾î´ðÅÍ´Â ¹°¸® ÆÄÀÌÇÁ¸¦ ´ÝÁö ¾Ê°í, ¹°¸® Á¢¼Ó¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø system resource¸¦ Àç¿ä±¸ÇÏÁö ¾Ê½À´Ï´Ù.
ResourceException
- Á¶ÀÛÀÌ ½ÇÆÐÇßÀ» °æ¿ì´Â ¹ü¿ëÀûÀÎ ¿¹¿ÜResourceAdapterInternalException
- ¸®¼Ò½º ¾î´ðÅÍ ³»ºÎ ¿¡·¯ »óÅÂIllegalStateException
- Á¢¼Ó Ŭ¸° ¾÷ È£Ãâ¿¡ ´ëÇÑ ºÎÁ¤ÇÑ »óÅÂ. ¿¹¸¦ µé¾î, Á¢¼Ó Ŭ¸° ¾÷À» Çã¶ôÇÏÁö ¾Ê´Â ·ÎÄà Ʈ·£Àè¼Ç(transaction)°¡ ÁøÇàÁßÀÇ °æ¿ì µîpublic void associateConnection(java.lang.Object connection) throws ResourceException
¸®¼Ò½º ¾î´ðÅÍ´Â associateConnection ¸Þ¼Òµå¸¦ ½ÇÀåÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù. ManagedConnection ÀÇ ¸Þ¼Òµå ½ÇÀåÀº, ÇöÀç °ü·ÃÁöÀ» ¼ö ÀÖ°í ÀÖ´Â ManagedConnection ·ÎºÎÅÍÀÇ Á¢¼Ó ÇÚµé (ÆÄ¶ó¹ÌÅͷμ °Ç³×¹Þ´Â´Ù)À» °ü·ÃÁþ°í ÇØÁ¦ÇØ, »õ·Î¿î Á¢¼Ó ÇÚµéÀ» ÀÚ±â Àڽſ¡°Ô °ü·ÃÁöÀ» Çʿ䰡 ÀÖ½À´Ï´Ù.
connection
- ¾îÇø®ÄÉÀÌ¼Ç ·¹º§ÀÇ Á¢¼Ó ÇÚµéResourceException
- Á¢¼Ó ÇÚµéÀ» ÀÌ ManagedConnection ÀνºÅϽº¿¡ °ü·ÃÁþ´Â °Í¿¡ ½ÇÆÐÇßÀ» °æ¿ìIllegalStateException
- ÀÌ ¸Þ¼ÒµåÀÇ È£Ãâ¿¡ ´ëÇÑ ºÎÁ¤ÇÑ »óÅÂResourceAdapterInternalException
- ¸®¼Ò½º ¾î´ðÅÍ ³»ºÎ ¿¡·¯ »óÅÂpublic void addConnectionEventListener(ConnectionEventListener listener)
µî·ÏµÇ¾î ÀÖ´Â ConnectionEventListener ÀνºÅϽº¿¡, Á¢¼ÓÀÇ Å¬·Î¿ìÁ ¿¡·¯ À̺¥Æ®°¡ ÅëÁöµË´Ï´Ù. ¶Ç, Managed Connection »óÀÇ ·ÎÄà Ʈ·£Àè¼Ç(transaction) °ü·Ã À̺¥Æ®µµ ÅëÁöµË´Ï´Ù.
listener
- µî·ÏµÇ´Â »õ·Î¿î ConnectionEventListenerpublic void removeConnectionEventListener(ConnectionEventListener listener)
listener
- »èÁ¦µÇ´Â ¹ú½á µî·ÏÀ» ¸¶Ä£ Á¢¼Ó À̺¥Æ® ûÃëÀÚpublic XAResource getXAResource() throws ResourceException
javax.transaction.xa.XAresource
ÀνºÅϽº¸¦ µ¹·ÁÁÝ´Ï´Ù. ManagedConnection ÀνºÅϽº°¡ Transaction Manager ¿¡ ÀÇÇØ Á¶Á¤µÇ´Â JTA Æ®·£Àè¼Ç(transaction)³»¿¡¼ »ç¿ëµÇ°í ÀÖ´Â °æ¿ì, ¾îÇø®ÄÉÀÌ¼Ç ¼¹ö´Â ÀÌ XAResource ÀνºÅϽº¸¦ Transaction Manager ¿¡ µî·ÏÇÕ´Ï´Ù. ResourceException
- Á¶ÀÛÀÌ ½ÇÆÐÇßÀ» °æ¿ì´Â ¹ü¿ëÀûÀÎ ¿¹¿ÜNotSupportedException
- Á¶ÀÛÀÌ ¼Æ÷Æ®µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ìResourceAdapterInternalException
- ¸®¼Ò½º ¾î´ðÅÍ ³»ºÎ ¿¡·¯ »óÅÂpublic LocalTransaction getLocalTransaction() throws ResourceException
javax.resource.spi.LocalTransaction
ÀνºÅϽº¸¦ µ¹·ÁÁÝ´Ï´Ù. LocalTransaction ÀÎÅÍÆäÀ̽º´Â, ÄÁÅ×À̳ʰ¡ RM ÀνºÅϽºÀÇ ·ÎÄà Ʈ·£Àè¼Ç(transaction)¸¦ °ü¸®Çϱâ À§Çؼ »ç¿ëµË´Ï´Ù. ResourceException
- Á¶ÀÛÀÌ ½ÇÆÐÇßÀ» °æ¿ì´Â ¹ü¿ëÀûÀÎ ¿¹¿ÜNotSupportedException
- Á¶ÀÛÀÌ ¼Æ÷Æ®µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ìResourceAdapterInternalException
- ¸®¼Ò½º ¾î´ðÅÍ ³»ºÎ ¿¡·¯ »óÅÂpublic ManagedConnectionMetaData getMetaData() throws ResourceException
ÀÌ Á¢¼ÓÀÇ ¹èÈÄÀÇ EIS ¸®¼Ò½º ¸Å´ÏÀú ÀνºÅϽº¿¡ ´ëÇÑ ¸ÞŸµ¥ÀÌŸ Á¤º¸¸¦ ÃëµæÇÕ´Ï´Ù. ManagedConnectionMetaData ÀÎÅÍÆäÀ̽º´Â, ManagedConenction ÀνºÅϽº¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¹èÈÄÀÇ EIS ÀνºÅϽº¿¡ °üÇÑ Á¤º¸¸¦ Á¦°øÇÕ´Ï´Ù.
ResourceException
- Á¶ÀÛÀÌ ½ÇÆÐÇßÀ» °æ¿ì´Â ¹ü¿ëÀûÀÎ ¿¹¿ÜNotSupportedException
- Á¶ÀÛÀÌ ¼Æ÷Æ®µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ìpublic void setLogWriter(java.io.PrintWriter out) throws ResourceException
·Î±× ¶óÀÌÅÍ´Â, ÀÌ ManagedConnection ÀνºÅϽº¿¡ °üÇÑ ¸ðµç ·Î±× ¹× Æ®·¹À̽º ¸Þ¼¼Áö°¡ ±âÀÔÇØÁö´Â ij¸¯ÅÍ Ãâ·Â ½Ã³Á¹°ÀÔ´Ï´Ù. Application Server ´Â, Ãâ·Â ½Ã³Á¹°°ú ManagedConnection ÀνºÅϽº¿ÍÀÇ °ü·ÃÀ» Á¢¼Ó Ç®¸µÀÇ ¿ä°Ç¿¡ ±Ù°ÅÇØ °ü¸®ÇÕ´Ï´Ù.
ManagedConnection ¿ÀºêÁ§Æ®ÀÇ Ãʱâ ÀÛ¼º½Ã, ÀÌ ÀνºÅϽº¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø µðÆúÆ®ÀÇ ·Î±× ¶óÀÌÅͰ¡, ManagedConnectionFactory ·ÎºÎÅÍ ÃëµæµË´Ï´Ù. ¾îÇø®ÄÉÀÌ¼Ç ¼¹ö´Â ÀÌ ManagedConnection ¿¡ °íÀ¯ÇÑ ·Î±× ¶óÀÌÅ͸¦ ¼³Á¤ÇØ, setLogWriter ¸Þ¼Òµå¸¦ »ç¿ëÇØ ÀÌ ÀνºÅϽºÀÇ ·Î±×/Æ®·¹À̽º¸¦ ó¸®ÇÒ ¼ö ÀÖ½À´Ï´Ù.
out
- °ü·ÃÁöÀ» ¼ö Àִ ij¸¯ÅÍ Ãâ·Â ½Ã³Á¹°ResourceException
- Á¶ÀÛÀÌ ½ÇÆÐÇßÀ» °æ¿ì´Â ¹ü¿ëÀûÀÎ ¿¹¿ÜResourceAdapterInternalException
- ¸®¼Ò½º ¾î´ðÅÍ °ü·ÃÀÇ ¿¡·¯ »óÅÂpublic java.io.PrintWriter getLogWriter() throws ResourceException
·Î±× ¶óÀÌÅÍ´Â, ÀÌ ManagedConnection ÀνºÅϽº¿¡ °üÇÑ ¸ðµç ·Î±× ¹× Æ®·¹À̽º ¸Þ¼¼Áö°¡ ±âÀÔÇØÁö´Â ij¸¯ÅÍ Ãâ·Â ½Ã³Á¹°ÀÔ´Ï´Ù. ConnectionManager ´Â, Ãâ·Â ½Ã³Á¹°°ú ManagedConnection ÀνºÅϽº¿ÍÀÇ °ü·ÃÀ» Á¢¼Ó Ç®¸µÀÇ ¿ä°Ç¿¡ ±Ù°ÅÇØ °ü¸®ÇÕ´Ï´Ù.
ManagedConnection ÀνºÅϽº¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ·Î±× ¶óÀÌÅÍ´Â, (ÀÌ Á¢¼ÓÀ» ÀÛ¼ºÇÑ) ManagedConnectionFactory ·ÎºÎÅÍ µðÆúÆ®·Î ¼³Á¤µÇ´Â °æ¿ìµµ ÀÖÀ¸¸é, ¾îÇø®ÄÉÀÌ¼Ç ¼¹ö¿¡ ÀÇÇØ, ÀÌ ÀνºÅϽº °íÀ¯ÇÏ°Ô ¼³Á¤µÇ´Â °æ¿ìµµ ÀÖ½À´Ï´Ù.
ResourceException
- Á¶ÀÛÀÌ ½ÇÆÐÇßÀ» °æ¿ì´Â ¹ü¿ëÀûÀÎ ¿¹¿Ü
|
|||||||||
ÀüÀÇ Å¬·¡½º ´ÙÀ½ÀÇ Å¬·¡½º | ÇÁ·¹ÀÓ ÀÖ¾î ÇÁ·¹ÀÓ ¾øÀ½ | ||||||||
°³¿ä: ³»ºÎ Ŭ·¡½º | Çʵå | constructor¡¡ ¡¡ | ¸Þ¼Òµå | »ó¼¼: Çʵå | constructor¡¡ ¡¡ | ¸Þ¼Òµå |