OpenJDK 8 - javax.sql.rowset.serial

पैकेज javax.sql.rowset.serial




openjdk

पैकेज javax.sql.rowset.serial

जावा प्रोग्रामिंग भाषा में SQL प्रकार और डेटा प्रकार के बीच क्रमिक परिवर्तन की अनुमति देने के लिए उपयोगिता कक्षाएं प्रदान करता है।

देखें: Description

कक्षा सारांश
कक्षा विवरण
SerialArray

एक Array ऑब्जेक्ट का क्रमबद्ध संस्करण, जो SQL ARRAY मान के जावा प्रोग्रामिंग भाषा में मैपिंग है।

SerialBlob

SQL BLOB मान के जावा प्रोग्रामिंग भाषा में क्रमबद्ध मैपिंग।

SerialClob

SQL CLOB मान की जावा प्रोग्रामिंग भाषा में क्रमबद्ध मैपिंग।

SerialDatalink

SQL DATALINK मान के जावा प्रोग्रामिंग भाषा में क्रमबद्ध मैपिंग।

SerialJavaObject

SQL JAVA_OBJECT मान के जावा प्रोग्रामिंग भाषा में क्रमिक मानचित्रण।

SerialRef

Ref वस्तु का क्रमबद्ध मानचित्रण, जो SQL REF मान के जावा प्रोग्रामिंग भाषा में मैपिंग है।

SerialStruct

SQL संरचित प्रकार के जावा प्रोग्रामिंग भाषा में एक क्रमबद्ध मैपिंग।

SQLInputImpl

कस्टम मैपिंग उपयोगकर्ता-परिभाषित प्रकार (UDTs) के लिए उपयोग की जाने वाली इनपुट स्ट्रीम।

SQLOutputImpl

डेटाबेस में कस्टम-मैप्ड उपयोगकर्ता-परिभाषित प्रकार (UDT) की विशेषताओं को लिखने के लिए आउटपुट स्ट्रीम।

अपवाद सारांश
अपवाद विवरण
SerialException

इंगित करता है और DATALINK and JAVAOBJECT जैसे SQL प्रकारों के अलावा SQL प्रकारों के क्रमांकन या डी-क्रमांकन जैसे BLOB, CLOB, STRUCT or ARRAY साथ एक त्रुटि

पैकेज javax.sql.rowset.serial विवरण

जावा प्रोग्रामिंग भाषा में SQL प्रकार और डेटा प्रकार के बीच क्रमिक परिवर्तन की अनुमति देने के लिए उपयोगिता कक्षाएं प्रदान करता है।

मानक JDBC RowSet कार्यान्वयन डिस्कनेक्ट RowSet गए RowSet ऑब्जेक्ट्स के क्रमांकन में सहायता करने के लिए इन उपयोगिता वर्गों का उपयोग कर सकते हैं। यह तब उपयोगी होता है जब किसी RowSet पर किसी अलग वीएम या किसी अनुप्रयोग के भीतर तार पर डिस्कनेक्ट RowSet ऑब्जेक्ट को ट्रांसमिट किया जाता है।

1.0 सीरियल

SQL ARRAY मान के जावा प्रोग्रामिंग भाषा में क्रमिक मानचित्रण।

SerialArray क्लास एक Array ऑब्जेक्ट से SerialArray इंस्टेंस बनाने के लिए एक कंस्ट्रक्टर प्रदान करता है, बेस टाइप के लिए SQL नाम और बेस टाइप के लिए SQL नाम, और SerialArray ऑब्जेक्ट के सभी या कुछ भाग को कॉपी करने के तरीके।

2.0 सीरियलबेल

SQL BLOB मान के जावा प्रोग्रामिंग भाषा में क्रमिक मानचित्रण।

SerialBlob वर्ग एक ब्लॉब ऑब्जेक्ट से एक उदाहरण बनाने के लिए एक कंस्ट्रक्टर प्रदान करता है। नोट करें कि SerialBlob ऑब्जेक्ट के निर्माण से पहले SerialBlob ऑब्जेक्ट को क्लाइंट पर SQL BLOB मान का डेटा लाना चाहिए। SQL BLOB मान का डेटा क्लाइंट पर बाइट्स की एक सरणी (विधि Blob.getBytes का उपयोग करके) या Blob.getBytes बाइट्स की एक धारा के रूप में (विधि Blob.getBinaryStream का उपयोग करके) किया जा सकता है।

SerialBlob मेथड्स को SerialBlob ऑब्जेक्ट की कॉपी बाइट्स या एक स्ट्रीम के रूप में बनाना संभव SerialBlob है। उन्होंने यह भी संभव है कि किसी दिए गए पैटर्न बाइट्स या एक SerialBlob ऑब्जेक्ट के भीतर एक Blob ऑब्जेक्ट का पता SerialBlob

3.0 सीरियलक्लब

SQL CLOB मान की जावा प्रोग्रामिंग भाषा में एक क्रमिक मानचित्रण।

SerialClob वर्ग एक Clob ऑब्जेक्ट से एक उदाहरण बनाने के लिए एक कंस्ट्रक्टर प्रदान करता है। ध्यान दें कि Clob ऑब्जेक्ट को SQL CLOB मान के डेटा को क्लाइंट के पास लाना चाहिए, इससे पहले कि SerialClob ऑब्जेक्ट का निर्माण किया जाए। SQL CLOB मान का डेटा क्लाइंट पर यूनिकोड वर्णों की एक धारा के रूप में भौतिक किया जा सकता है।

SerialClob विधियाँ SerialClob ऑब्जेक्ट से एक SerialClob करना या वर्णों के पैटर्न की शुरुआत का पता लगाना संभव बनाती हैं।

5.0 सिरियलडालिंक

SQL DATALINK मान के जावा प्रोग्रामिंग भाषा में क्रमिक मानचित्रण। DATALINK मान अंतर्निहित डेटा स्रोत के बाहर एक फ़ाइल को संदर्भित करता है जो कि मूल डेटा स्रोत का प्रबंधन करता है।

RowSet कार्यान्वयन एक java.net.URL ऑब्जेक्ट को पुनः प्राप्त करने के लिए RowSet.getURL() विधि का उपयोग कर सकता है, जिसका उपयोग बाहरी डेटा में हेरफेर करने के लिए किया जा सकता है।

java.net.URL url = rowset.getURL(1);

6.0 SerialJavaObject

SQL JAVA_OBJECT मान के जावा प्रोग्रामिंग भाषा में क्रमिक मानचित्रण। जावा ऑब्जेक्ट उदाहरण मानते हुए सीरियल इंटरफ़ेस को लागू करता है, यह बस क्रमबद्धता प्रक्रिया को लपेटता है।

यदि हां, तो उस मामले में क्रमांकन संभव नहीं है जहां जावा ऑब्जेक्ट को तुरंत सीरियल करने योग्य नहीं है, यह वर्ग सभी गैर स्थिर सदस्यों को क्रमबद्ध करने की कोशिश करेगा ताकि ऑब्जेक्ट उदाहरण राज्य को क्रमबद्ध किया जा सके। स्थिर या क्षणिक क्षेत्रों को क्रमबद्ध नहीं किया जा सकता है और ऐसा करने का प्रयास एक SerialException परिणाम होगा।

7.0 सीरीयल रीफ

SQL REF प्रकार और जावा प्रोग्रामिंग भाषा के बीच एक क्रमिक मानचित्रण।

SerialRef क्लास Ref प्रकार से SerialRef इंस्टेंस बनाने के लिए एक SerialRef प्रदान करता है और Ref प्रकार प्राप्त करने और सेट करने के लिए तरीके प्रदान करता है।

Ruct.० सिरियलस्ट्रोक्ट

SQL संरचित प्रकार के जावा प्रोग्रामिंग भाषा में एक क्रमिक मानचित्रण। प्रत्येक विशेषता जो पहले से ही सीरियल करने योग्य नहीं है, को क्रमबद्ध रूप में मैप किया जाता है, और यदि एक विशेषता स्वयं एक संरचित प्रकार है, तो इसकी प्रत्येक विशेषता जो पहले से ही अनुक्रमिक नहीं है, क्रमबद्ध रूप में मैप की जाती है।

इसके अलावा, यदि कोई Map ऑब्जेक्ट कंस्ट्रक्टरों में से किसी एक को या विधि getAttributes , तो संरचित प्रकार मैप ऑब्जेक्ट में निर्दिष्ट मानचित्रण के अनुसार कस्टम मैप किया जाता है।
SerialStruct वर्ग एक संरचना ऑब्जेक्ट से एक उदाहरण बनाने के लिए एक कंस्ट्रक्टर प्रदान करता है, डेटाबेस में SQL संरचित प्रकार के SQL टाइप नाम को पुनः प्राप्त करने के लिए एक विधि और इसके विशेषता मानों को पुनर्प्राप्त करने के लिए तरीके।

9.0 SQLInputImpl

कस्टम मैपिंग उपयोगकर्ता-परिभाषित प्रकार (UDTs) के लिए उपयोग की जाने वाली इनपुट स्ट्रीम। SQLInputImpl ऑब्जेक्ट एक इनपुट स्ट्रीम है जिसमें उन मानों की एक धारा शामिल होती है जो UDT के गुण हैं। इस क्लास का उपयोग ड्राइवर द्वारा पर्दे के पीछे किया जाता है जब विधि getObject को SQL संरचित या विशिष्ट प्रकार पर कॉल किया जाता है जिसमें कस्टम getObject है; एक प्रोग्रामर कभी भी SQLInputImpl तरीकों को सीधे नहीं करता है।

SQLInputImpl वर्ग SQLInputImpl विधियों के अनुरूप रीडर विधियों का एक सेट प्रदान करता है। ये विधियाँ SQLInputImpl ऑब्जेक्ट में मानों को पढ़ना संभव बनाती हैं। इस विधि का उपयोग यह निर्धारित करने के लिए किया जाता है कि अंतिम मान पढ़ा गया SQL NULL था या नहीं।

जब कोई कंस्ट्रक्टर या SQLData.getSQLType मेथड, जो ऑब्जेक्ट को Map है, कहलाता है, JDBC ड्राइवर, SQLData.getSQLType को यूडीटी के SQL प्रकार को कस्टम मैप करने के लिए निर्धारित करता है। ड्राइवर SQLInputImpl का एक उदाहरण बनाता है, इसे UDT की विशेषताओं के साथ पॉप्युलेट करता है। ड्राइवर तब इनपुट स्ट्रीम को मेथड SQLData.readSQL , जो बदले में इनपुट स्ट्रीम से विशेषताओं को पढ़ने के लिए SQLInputImpl तरीके कहता है।

10.0 SQLOutputImpl

डेटाबेस के लिए कस्टम मैप्ड उपयोगकर्ता-परिभाषित प्रकार (UDT) की विशेषताओं को लिखने के लिए आउटपुट स्ट्रीम। ड्राइवर इस इंटरफ़ेस का आंतरिक रूप से उपयोग करता है, और इसके तरीकों को कभी भी एप्लिकेशन प्रोग्रामर द्वारा सीधे नहीं लगाया जाता है।

जब कोई एप्लिकेशन MethodedStatement.setObject विधि को कॉल करता है PreparedStatement.setObject, तो ड्राइवर यह देखने के लिए जांचता है कि क्या लिखा जाने वाला मूल्य एक कस्टम मैपिंग के साथ UDT है या नहीं। यदि ऐसा है, तो क्लास के लिए क्लास ऑब्जेक्ट युक्त एक प्रकार के मानचित्र में एक प्रविष्टि होगी जो इस UDT के लिए SQLData को लागू SQLData । यदि लिखा जाने वाला मान SQLData का एक उदाहरण है, तो ड्राइवर SQLOutputImpl का एक उदाहरण SQLOutputImpl और इसे SQLData.writeSQL विधि से पारित SQLData.writeSQL । बदले में writeSQL गई मेथड writeSQL SQL SQL डेटा से SQLOutputImpl लेखक विधियों को SQLOutputImpl आउटपुट स्ट्रीम से SQLOutputImpl आउटपुट स्ट्रीम डेटा SQLData करने के लिए SQLOutputImpl

कस्टम मानचित्रण

JDBC API एक SQL संरचित प्रकार या DISTINCT प्रकार की मैपिंग के लिए जावा प्रोग्रामिंग लैंग्वेज के लिए मैकेनिज्म प्रदान करता है। आमतौर पर, एक संरचित प्रकार को क्लास में मैप किया जाता है, और इसकी विशेषताओं को क्लास में फ़ील्ड्स में मैप किया जाता है। (एक DISTINCT प्रकार को एक विशेषता के रूप में माना जा सकता है।) हालांकि, कई अन्य संभावनाएं हैं, और किसी भी संख्या में अलग-अलग मैपिंग हो सकती हैं।

एक प्रोग्रामर इंटरफ़ेस SQLData को लागू करके मैपिंग को परिभाषित करता है। उदाहरण के लिए, यदि एक SQL संरचित प्रकार के AUTHORS में NAME, TITLE और PUBLISHER की विशेषताएँ हैं, तो इसे एक जावा कक्षा में लेखक नाम दिया जा सकता है। लेखक वर्ग फ़ील्ड का नाम, शीर्षक और प्रकाशक हो सकता है, जिसमें AUTHORS की विशेषताएँ मैप की गई हैं। ऐसे मामले में, SQLData का कार्यान्वयन निम्नलिखित की तरह लग सकता है:

public class Authors implements SQLData {
       public String name;
       public String title;
       public String publisher;

       private String sql_type;
       public String getSQLTypeName() {
           return sql_type;
       }

       public void readSQL(SQLInput stream, String type)
                                  throws SQLException  {
           sql_type = type;
           name = stream.readString();
           title = stream.readString();
           publisher = stream.readString();
       }

       public void writeSQL(SQLOutput stream) throws SQLException {
           stream.writeString(name);
           stream.writeString(title);
           stream.writeString(publisher);
       }
   }
एक java.util.Map ऑब्जेक्ट का उपयोग SQL संरचित प्रकार को क्लास Authors मैपिंग के साथ जोड़ने के लिए किया जाता है। निम्न कोड टुकड़ा दिखाता है कि Map ऑब्जेक्ट कैसे बनाया जा सकता है और उसे AUTHORS और AUTHORS एक प्रविष्टि दी जाती है।
java.util.Map map = new java.util.HashMap();
    map.put("SCHEMA_NAME.AUTHORS", Class.forName("Authors");
Map ऑब्जेक्ट मैप में अब SQL संरचित प्रकार के पूरी तरह से योग्य नाम और क्लास Authors लिए Class ऑब्जेक्ट के साथ एक प्रविष्टि है। यह ड्राइवर को यह बताने के लिए एक विधि को पारित किया जा सकता है कि AUTHORS को AUTHORS कैसे मैप किया जाए।

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