OpenJDK 8 - Driver

इंटरफ़ेस ड्राइवर




openjdk

इंटरफ़ेस ड्राइवर

public interface Driver

इंटरफ़ेस जिसे प्रत्येक ड्राइवर वर्ग को लागू करना चाहिए।

जावा SQL फ्रेमवर्क कई डेटाबेस ड्राइवरों के लिए अनुमति देता है।

प्रत्येक ड्राइवर को एक वर्ग की आपूर्ति करनी चाहिए जो चालक इंटरफ़ेस को लागू करता है।

DriverManager को जितने ड्राइवर मिल सकते हैं उतने लोड करने की कोशिश करेंगे और फिर किसी भी कनेक्शन के अनुरोध के लिए, यह प्रत्येक ड्राइवर को लक्ष्य URL से कनेक्ट करने का प्रयास करने के लिए कहेंगे।

यह दृढ़ता से अनुशंसा की जाती है कि प्रत्येक चालक वर्ग छोटा और स्टैंडअलोन होना चाहिए, ताकि चालक वर्ग को भारी मात्रा में सहायक कोड लाए बिना लोड किया जा सके।

जब ड्राइवर वर्ग लोड होता है, तो उसे स्वयं का एक उदाहरण बनाना चाहिए और उसे DriverManager के साथ पंजीकृत करना चाहिए। इसका मतलब है कि उपयोगकर्ता कॉल करके ड्राइवर को लोड और पंजीकृत कर सकता है:

Class.forName("foo.bah.Driver")

JDBC ड्राइवर को DriverManager.deregisterDriver(java.sql.Driver) कहा जाता है जब सूचनाएं प्राप्त करने के लिए एक DriverAction कार्यान्वयन बना सकते हैं।

यह भी देखें:
DriverManager , Connection , DriverAction

तरीके

जुडिये

Connection connect(String url,
                   Properties info)
            throws SQLException

दिए गए URL से एक डेटाबेस कनेक्शन बनाने का प्रयास। ड्राइवर को "अशक्त" वापस करना चाहिए यदि यह पता चलता है कि यह दिए गए URL से कनेक्ट करने के लिए गलत प्रकार का ड्राइवर है। यह सामान्य होगा, क्योंकि जब JDBC ड्राइवर प्रबंधक को दिए गए URL से कनेक्ट करने के लिए कहा जाता है, तो वह प्रत्येक लोड किए गए ड्राइवर को बदले में URL पास करता है।

ड्राइवर को एक SQLException को फेंकना चाहिए यदि यह दिए गए URL से कनेक्ट करने के लिए सही ड्राइवर है लेकिन डेटाबेस से कनेक्ट करने में समस्या है।

Properties तर्क का उपयोग कनेक्शन तर्कों के रूप में मनमाने स्ट्रिंग टैग / मूल्य जोड़े को पास करने के लिए किया जा सकता है। आम तौर पर कम से कम "उपयोगकर्ता" और "पासवर्ड" गुणों को Properties ऑब्जेक्ट में शामिल किया जाना चाहिए।

नोट: यदि कोई संपत्ति url हिस्से के रूप में निर्दिष्ट की गई है और Properties ऑब्जेक्ट में भी निर्दिष्ट है, तो इसे कार्यान्वयन-परिभाषित किया जाता है, जिसके लिए मूल्य पूर्वता ले जाएगा। अधिकतम पोर्टेबिलिटी के लिए, एक एप्लिकेशन को केवल एक बार एक संपत्ति निर्दिष्ट करनी चाहिए।

पैरामीटर:
url - डेटाबेस का URL जिससे जुड़ना है
info - कनेक्शन तर्क के रूप में मनमाने स्ट्रिंग टैग / मूल्य जोड़े की एक सूची। आम तौर पर कम से कम एक "उपयोगकर्ता" और "पासवर्ड" संपत्ति को शामिल किया जाना चाहिए।
यह दिखाता है:
एक Connection ऑब्जेक्ट जो URL से कनेक्शन का प्रतिनिधित्व करता है
फेंकता:
SQLException - यदि डेटाबेस एक्सेस एरर आता है या url null

acceptsURL

boolean acceptsURL(String url)
            throws SQLException

यह सोचता है कि क्या ड्राइवर को लगता है कि यह दिए गए URL से कनेक्शन खोल सकता है। यदि वे URL में निर्दिष्ट उप-प्रोटोकॉल को समझते हैं और नहीं तो false पर आमतौर पर ड्राइवर true लौटेगा।

पैरामीटर:
url - डेटाबेस का URL
यह दिखाता है:
true अगर यह ड्राइवर दिए गए URL को समझता है; false अन्यथा
फेंकता:
SQLException - यदि डेटाबेस एक्सेस एरर आता है या url null

getPropertyInfo

DriverPropertyInfo[] getPropertyInfo(String url,
                                     Properties info)
                              throws SQLException

इस ड्राइवर के लिए संभावित गुणों के बारे में जानकारी प्राप्त करता है।

getPropertyInfo विधि का उद्देश्य एक सामान्य GUI टूल को खोजने की अनुमति देना है, जो किसी डेटाबेस से कनेक्ट होने के लिए पर्याप्त जानकारी प्राप्त करने के लिए किसी मानव को क्या गुण चाहिए। ध्यान दें कि मानव ने अब तक जिन मूल्यों की आपूर्ति की है, उसके आधार पर, अतिरिक्त मूल्य आवश्यक हो सकते हैं, इसलिए यह आवश्यक हो सकता है, हालांकि getPropertyInfo विधि में कई कॉल करें।

पैरामीटर:
url - डेटाबेस का URL जिससे जुड़ना है
info - टैग / मूल्य जोड़े की एक प्रस्तावित सूची जो कनेक्ट ओपन पर भेजी जाएगी
यह दिखाता है:
DriverPropertyInfo ऑब्जेक्ट्स के संभावित गुणों का वर्णन करने वाली एक सरणी। यदि कोई गुण आवश्यक नहीं है, तो यह सरणी एक खाली सरणी हो सकती है।
फेंकता:
SQLException - यदि डेटाबेस एक्सेस एरर होता है

getMajorVersion

int getMajorVersion()

ड्राइवर के प्रमुख संस्करण संख्या को पुनः प्राप्त करता है। प्रारंभ में यह 1 होना चाहिए।

यह दिखाता है:
यह ड्राइवर का प्रमुख संस्करण नंबर है

getMinorVersion

int getMinorVersion()

ड्राइवर का मामूली संस्करण संख्या प्राप्त करता है। प्रारंभ में यह 0 होना चाहिए।

यह दिखाता है:
यह ड्राइवर का मामूली संस्करण संख्या है

jdbcCompliant

boolean jdbcCompliant()

रिपोर्ट करता है कि क्या यह ड्राइवर वास्तविक JDBC कंप्लेंट ™ ड्राइवर है। यदि JDBC अनुपालन परीक्षण पास करता है, तो एक ड्राइवर ही यहां रिपोर्ट कर सकता है; अन्यथा false को वापस करना आवश्यक है।

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

यह विधि गैर-जेडीबीसी अनुरूप ड्राइवरों के विकास को प्रोत्साहित करने के लिए नहीं है, लेकिन इस तथ्य की मान्यता है कि कुछ विक्रेता हल्के डेटाबेस के लिए जेडडीबीसी एपीआई और फ्रेमवर्क का उपयोग करने में रुचि रखते हैं जो पूर्ण डेटाबेस कार्यक्षमता, या विशेष डेटाबेस के लिए समर्थन नहीं करते हैं। जैसे दस्तावेज़ जानकारी पुनर्प्राप्ति जहां एक SQL कार्यान्वयन संभव नहीं है।

यह दिखाता है:
true अगर यह ड्राइवर JDBC कंप्लेंट है; false अन्यथा

getParentLogger

Logger getParentLogger()
                throws SQLFeatureNotSupportedException

इस ड्राइवर द्वारा उपयोग किए जाने वाले सभी लॉगर के पैरेंट लॉगर को लौटाएं। यह रूट लॉगर से लॉगर सबसे दूर होना चाहिए जो अभी भी इस ड्राइवर द्वारा उपयोग किए जाने वाले लॉगर के सभी का पूर्वज है। इस लकड़हारे को कॉन्फ़िगर करने से चालक द्वारा उत्पन्न सभी लॉग संदेश प्रभावित होंगे। सबसे खराब स्थिति में, यह रूट लॉगर हो सकता है।

यह दिखाता है:
इस ड्राइवर के लिए जनक लकड़हारा
फेंकता:
SQLFeatureNotSupportedException - अगर ड्राइवर java.util.logging उपयोग नहीं करता है।
जबसे:
1.7