OpenJDK 8 - PooledConnection

इंटरफ़ेस




openjdk

इंटरफ़ेस

सभी ज्ञात उपप्रकारों:
XAConnection
public interface PooledConnection

एक वस्तु जो कनेक्शन पूल प्रबंधन के लिए हुक प्रदान करती है। किसी PooledConnection ऑब्जेक्ट डेटा स्रोत के लिए भौतिक कनेक्शन का प्रतिनिधित्व करता है। किसी अनुप्रयोग के साथ समाप्त होने पर कनेक्शन को बंद किए जाने के बजाय पुनर्नवीनीकरण किया जा सकता है, इस प्रकार उन कनेक्शनों की संख्या को कम किया जा सकता है जिन्हें बनाने की आवश्यकता है।

एक प्रोग्रामर प्रोग्रामर सीधे PooledConnection इंटरफेस का उपयोग नहीं करता है; बल्कि, इसका उपयोग एक मध्य स्तरीय बुनियादी ढाँचे द्वारा किया जाता है जो कनेक्शनों की पूलिंग का प्रबंधन करता है।

जब कोई अनुप्रयोग DataSource.getConnection विधि को कॉल करता है, तो उसे Connection ऑब्जेक्ट वापस मिल जाता है। यदि कनेक्शन पूलिंग किया जा रहा है, तो वह Connection ऑब्जेक्ट वास्तव में एक PooledConnection ऑब्जेक्ट का हैंडल है, जो एक भौतिक कनेक्शन है।

कनेक्शन पूल प्रबंधक, आमतौर पर एप्लिकेशन सर्वर, PooledConnection ऑब्जेक्ट्स के एक पूल को बनाए रखता है। यदि पूल में कोई PooledConnection ऑब्जेक्ट उपलब्ध है, तो कनेक्शन पूल प्रबंधक एक Connection ऑब्जेक्ट देता है जो उस भौतिक कनेक्शन के लिए एक हैंडल है। यदि कोई PooledConnection ऑब्जेक्ट उपलब्ध नहीं है, तो कनेक्शन पूल प्रबंधक एक नया शारीरिक संबंध बनाने के लिए ConnectionPoolDataSource विधि getPoolConnection को कॉल करता है। ConnectionPoolDataSource लागू करने वाला JDBC ड्राइवर एक नया PooledConnection ऑब्जेक्ट बनाता है और इसे हैंडल करता है।

जब कोई एप्लिकेशन कनेक्शन बंद करता है, तो वह Connection विधि को close । जब कनेक्शन पूलिंग की जा रही है, तो कनेक्शन पूल प्रबंधक को सूचित किया जाता है क्योंकि उसने ConnectionPool विधि addConnectionEventListener का उपयोग करके खुद को एक ConnectionEventListener ऑब्जेक्ट के रूप में पंजीकृत किया है। कनेक्शन पूल प्रबंधक PooledConnection ऑब्जेक्ट के लिए हैंडल को निष्क्रिय करता है और कनेक्शन के पूल में PooledConnection ऑब्जेक्ट लौटाता है ताकि इसे फिर से उपयोग किया जा सके। इस प्रकार, जब कोई एप्लिकेशन अपना कनेक्शन बंद करता है, तो अंतर्निहित भौतिक कनेक्शन को बंद किए जाने के बजाय पुनर्नवीनीकरण किया जाता है।

जब तक कनेक्शन पूल प्रबंधक PooledConnection विधि को बंद नहीं करता तब तक भौतिक कनेक्शन बंद नहीं होता है। इस पद्धति को आम तौर पर सर्वर के एक क्रमिक शटडाउन के लिए कहा जाता है या यदि एक घातक त्रुटि ने कनेक्शन को अनुपयोगी बना दिया है।

एक कनेक्शन पूल प्रबंधक अक्सर एक स्टेटमेंट पूल मैनेजर भी होता है, जो कि PreparedStatement ऑब्जेक्ट्स के पूल को बनाए रखता है। जब कोई एप्लिकेशन तैयार किए गए स्टेटमेंट को बंद कर देता है, तो वह PreparedStatement विधि को close । जब Statement पूलिंग की जा रही होती है, तो पूल मैनेजर को सूचित किया जाता है क्योंकि उसने खुद को एक ConnectionPool रूप में दर्ज किया है जो कि addStatementEventListener । इस प्रकार, जब कोई एप्लिकेशन अपने PreparedStatement बंद कर देता है, तो अंतर्निहित तैयार विवरण को बंद किए जाने के बजाय पुनर्नवीनीकरण किया जाता है।

जबसे:
1.4

तरीके

getConnection

Connection getConnection()
                  throws SQLException

एक Connection ऑब्जेक्ट बनाता है और देता है जो कि उस भौतिक कनेक्शन के लिए एक हैंडल है जिसे यह PooledConnection ऑब्जेक्ट दर्शाता है। कनेक्शन पूल प्रबंधक इस विधि को तब कॉल करता है जब किसी एप्लिकेशन ने DataSource.getConnection नामक विधि को बुलाया है और कोई PooledConnection उपलब्ध नहीं है। अधिक जानकारी के लिए interface description देखें।

यह दिखाता है:
एक Connection ऑब्जेक्ट जो इस PooledConnection ऑब्जेक्ट के लिए एक हैंडल है
फेंकता:
SQLException - यदि डेटाबेस एक्सेस एरर होता है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.4

बंद करे

void close()
    throws SQLException

उस भौतिक कनेक्शन को बंद कर देता है जिसे यह PooledConnection ऑब्जेक्ट दर्शाता है। एक आवेदन सीधे इस विधि को कभी नहीं कहता है; इसे कनेक्शन पूल मॉड्यूल, या प्रबंधक द्वारा कहा जाता है।

अधिक जानकारी के लिए interface description देखें।

फेंकता:
SQLException - यदि डेटाबेस एक्सेस एरर होता है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.4

addConnectionEventListener

void addConnectionEventListener(ConnectionEventListener listener)

दिए गए ईवेंट श्रोता को पंजीकृत करता है ताकि यह सूचित हो जाए जब कोई घटना इस PooledConnection ऑब्जेक्ट पर होती है।

पैरामीटर:
listener - एक घटक, आमतौर पर कनेक्शन पूल प्रबंधक, जिसने ConnectionEventListener इंटरफ़ेस को लागू किया है और जब कनेक्शन बंद हो जाता है या कोई त्रुटि होती है तो उसे सूचित किया जाना चाहता है
यह भी देखें:
removeConnectionEventListener(javax.sql.ConnectionEventListener)

removeConnectionEventListener

void removeConnectionEventListener(ConnectionEventListener listener)

दिए गए ईवेंट श्रोता को उन घटकों की सूची से हटा देता है, जिन्हें इस PooledConnection ऑब्जेक्ट पर कोई ईवेंट होने पर सूचित किया जाएगा।

पैरामीटर:
listener - एक घटक, आमतौर पर कनेक्शन पूल प्रबंधक, जिसने PooledConnection इंटरफ़ेस लागू किया है और श्रोता के रूप में इस PooledConnection ऑब्जेक्ट के साथ पंजीकृत किया गया है
यह भी देखें:
addConnectionEventListener(javax.sql.ConnectionEventListener)

addStatementEventListener

void addStatementEventListener(StatementEventListener listener)

इस PooledConnection ऑब्जेक्ट के साथ एक StatementEventListener PooledConnection पंजीकृत करता है। जब कनेक्शन द्वारा बनाई गई PooledConnection को बंद कर दिया जाता है या अमान्य पाया जाता है, तो अधिसूचित होने की इच्छा रखने वाले घटक इस विधि का उपयोग इस PooledConnection ऑब्जेक्ट के साथ StatementEventListener को पंजीकृत करने में कर सकते हैं।

पैरामीटर:
listener - एक घटक जो StatementEventListener लागू करता है।
जबसे:
1.6

removeStatementEventListener

void removeStatementEventListener(StatementEventListener listener)

निर्दिष्ट StatementEventListener EventListener घटकों की सूची से निकालता है जो तब अधिसूचित किया जाएगा जब चालक यह पता लगाता है कि एक PreparedStatement बंद कर दिया गया है या अमान्य है।

पैरामीटर:
listener - वह घटक जो पहले से ही इस PooledConnection ऑब्जेक्ट के साथ पंजीकृत किया गया StatementEventListener इंटरफ़ेस को लागू करता है
जबसे:
1.6