OpenJDK 8 - Array

इंटरफ़ेस सरणी




openjdk

इंटरफ़ेस सरणी

सभी ज्ञात कार्यान्वयन कक्षाएं:
SerialArray
public interface Array

SQL प्रोग्रामिंग ARRAY लिए जावा प्रोग्रामिंग भाषा में मैपिंग। डिफ़ॉल्ट रूप से, एक Array मान SQL ARRAY मान के लिए लेन-देन-अवधि का संदर्भ है। डिफ़ॉल्ट रूप से, एक Array ऑब्जेक्ट आंतरिक रूप से SQL LOCATOR (ऐरे) का उपयोग करके कार्यान्वित किया जाता है, जिसका अर्थ है कि एक Array ऑब्जेक्ट में ARRAY मान के डेटा को रखने के बजाय SQL ARRAY मान में डेटा के लिए एक तार्किक सूचक होता है।

Array इंटरफ़ेस क्लाइंट को SQL ARRAY मान के डेटा को ऐरे या ResultSet ऑब्जेक्ट के रूप में लाने के लिए विधियाँ प्रदान करता है। यदि SQL ARRAY के तत्व UDT हैं, तो वे कस्टम मैप किए जा सकते हैं। कस्टम मैपिंग बनाने के लिए, एक प्रोग्रामर को दो काम करने होंगे:

  • कस्टम मैप किए जाने के लिए UDT के लिए SQLData इंटरफ़ेस लागू करने वाला वर्ग बनाएं।
  • एक प्रकार के मानचित्र में एक प्रविष्टि करें जिसमें सम्‍मिलित हो
    • UDT का पूरी तरह से योग्य SQL प्रकार का नाम
    • SQLData लागू करने SQLData कक्षा के लिए Class ऑब्जेक्ट

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

यदि JDBC ड्राइवर डेटा प्रकार का समर्थन करता है, तो Array इंटरफ़ेस पर सभी तरीके पूरी तरह से लागू होने चाहिए।

जबसे:
1.2

तरीके

getBaseTypeName

String getBaseTypeName()
                throws SQLException

इस Array ऑब्जेक्ट द्वारा निर्दिष्ट सरणी में तत्वों के SQL प्रकार का नाम Array है। यदि तत्व एक अंतर्निहित प्रकार हैं, तो यह तत्वों के डेटाबेस-विशिष्ट प्रकार का नाम देता है। यदि तत्व उपयोगकर्ता-परिभाषित प्रकार (UDT) हैं, तो यह विधि पूरी तरह से योग्य SQL प्रकार का नाम देता है।

यह दिखाता है:
एक String जो एक अंतर्निहित आधार प्रकार के लिए डेटाबेस-विशिष्ट नाम है; या UDT के आधार प्रकार के लिए पूरी तरह से योग्य SQL प्रकार का नाम
फेंकता:
SQLException - यदि टाइप नाम को एक्सेस करने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getBaseType

int getBaseType()
         throws SQLException

इस Array ऑब्जेक्ट द्वारा निर्दिष्ट सरणी में JDBC प्रकार के तत्वों को पुनः प्राप्त करता है।

यह दिखाता है:
श्रेणी से एक स्थिरांक जो इस Array ऑब्जेक्ट द्वारा निर्दिष्ट सरणी में तत्वों के लिए प्रकार कोड है
फेंकता:
SQLException - यदि आधार प्रकार तक पहुंचने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getArray

Object getArray()
         throws SQLException

जावा प्रोग्रामिंग भाषा में सरणी के रूप में इस Array ऑब्जेक्ट द्वारा निर्दिष्ट SQL ARRAY मान की सामग्री को पुनर्प्राप्त करता है। विधि का यह संस्करण getArray प्रकार मैपिंग के अनुकूलन के लिए कनेक्शन के साथ जुड़े प्रकार के नक्शे का उपयोग करता है।

ध्यान दें: जब getArray का उपयोग आधार प्रकार को getArray लिए किया जाता है जो कि किसी आदिम डेटा प्रकार पर मैप करता है, तो यह कार्यान्वयन-परिभाषित होता है कि लौटाया गया सरणी उस आदिम डेटा प्रकार या Object की एक सरणी है।

यह दिखाता है:
जावा प्रोग्रामिंग भाषा में एक सरणी जिसमें इस Array ऑब्जेक्ट द्वारा निर्दिष्ट SQL ARRAY मान के आदेशित तत्व शामिल हैं
फेंकता:
SQLException - यदि सरणी तक पहुंचने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getArray

Object getArray(Map<String,Class<?>> map)
         throws SQLException

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

ध्यान दें: जब getArray का उपयोग आधार प्रकार को getArray लिए किया जाता है जो कि किसी आदिम डेटा प्रकार पर मैप करता है, तो यह कार्यान्वयन-परिभाषित होता है कि लौटाया गया सरणी उस आदिम डेटा प्रकार या Object की एक सरणी है।

पैरामीटर:
map - एक java.util.Map ऑब्जेक्ट जिसमें जावा प्रोग्रामिंग भाषा में कक्षाओं के लिए SQL प्रकार के नाम की मैपिंग होती है
यह दिखाता है:
जावा प्रोग्रामिंग भाषा में एक सरणी जिसमें इस ऑब्जेक्ट द्वारा निर्दिष्ट SQL सरणी के आदेशित तत्व शामिल हैं
फेंकता:
SQLException - यदि सरणी तक पहुंचने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getArray

Object getArray(long index,
                int count)
         throws SQLException

इस Array ऑब्जेक्ट द्वारा निर्दिष्ट SQL ARRAY मान का एक टुकड़ा प्राप्त करता है, निर्दिष्ट index साथ शुरुआत और SQL सरणी के क्रमिक तत्वों को count के लिए। यह विधि टाइप मैपिंग के अनुकूलन के लिए कनेक्शन से जुड़े टाइप मैप का उपयोग करती है।

ध्यान दें: जब getArray का उपयोग आधार प्रकार को getArray लिए किया जाता है जो कि किसी आदिम डेटा प्रकार पर मैप करता है, तो यह कार्यान्वयन-परिभाषित होता है कि लौटाया गया सरणी उस आदिम डेटा प्रकार या Object की एक सरणी है।

पैरामीटर:
index - पुनः प्राप्त करने के लिए पहले तत्व का सरणी सूचकांक; पहला तत्व इंडेक्स 1 पर है
count - क्रमिक SQL सरणी तत्वों की संख्या को पुनः प्राप्त करने के लिए
यह दिखाता है:
तत्व सरणी के साथ शुरुआत करते हुए SQL सरणी के लगातार तत्वों को count लिए एक सरणी
फेंकता:
SQLException - यदि सरणी तक पहुंचने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getArray

Object getArray(long index,
                int count,
                Map<String,Class<?>> map)
         throws SQLException

इस Array ऑब्जेक्ट द्वारा निर्दिष्ट SQL ARRAY मान का एक टुकड़ा फिर से निर्दिष्ट index साथ शुरुआत और SQL सरणी के क्रमिक तत्वों की count करने के लिए युक्त।

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

ध्यान दें: जब getArray का उपयोग आधार प्रकार को getArray लिए किया जाता है जो कि किसी आदिम डेटा प्रकार पर मैप करता है, तो यह कार्यान्वयन-परिभाषित होता है कि लौटाया गया सरणी उस आदिम डेटा प्रकार या Object की एक सरणी है।

पैरामीटर:
index - पुनः प्राप्त करने के लिए पहले तत्व का सरणी सूचकांक; पहला तत्व इंडेक्स 1 पर है
count - क्रमिक SQL सरणी तत्वों की संख्या को पुनः प्राप्त करने के लिए
map - एक java.util.Map ऑब्जेक्ट जिसमें SQL प्रकार के नाम और जावा प्रोग्रामिंग भाषा में वर्ग हैं जिसमें उन्हें मैप किया गया है
यह दिखाता है:
इस Array ऑब्जेक्ट द्वारा निर्दिष्ट SQL ARRAY मान के लगातार तत्वों को count लिए एक Array है, जो तत्व index साथ शुरू होता है
फेंकता:
SQLException - यदि सरणी तक पहुंचने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getResultSet

ResultSet getResultSet()
                throws SQLException

एक परिणाम सेट को पुनः प्राप्त करता है जिसमें इस Array ऑब्जेक्ट द्वारा निर्दिष्ट SQL ARRAY मान के तत्व शामिल हैं। यदि उपयुक्त हो, तो कनेक्शन के प्रकार के नक्शे का उपयोग करके सरणी के तत्वों को मैप किया जाता है; अन्यथा, मानक मैपिंग का उपयोग किया जाता है।

परिणाम सेट में प्रत्येक पंक्ति तत्व के लिए एक पंक्ति होती है, जिसमें प्रत्येक पंक्ति में दो कॉलम होते हैं। दूसरा स्तंभ तत्व मान संग्रहीत करता है; पहला कॉलम उस तत्व के लिए इंडेक्स को स्टोर करता है (पहला एरे तत्व एलिमेंट 1 पर होने के साथ)। पंक्तियाँ सूचकांकों के क्रम के अनुसार आरोही क्रम में हैं।

यह दिखाता है:
इस Array ऑब्जेक्ट द्वारा निर्दिष्ट सरणी में तत्वों में से प्रत्येक के लिए एक पंक्ति वाली एक ResultSet वस्तु, सूचकांक के आधार पर आरोही क्रम में पंक्तियों के साथ।
फेंकता:
SQLException - यदि सरणी तक पहुंचने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getResultSet

ResultSet getResultSet(Map<String,Class<?>> map)
                throws SQLException

एक परिणाम सेट को पुनः प्राप्त करता है जिसमें इस Array ऑब्जेक्ट द्वारा निर्दिष्ट SQL ARRAY मान के तत्व शामिल हैं। यह विधि प्रकार के मानचित्र अनुकूलन के लिए निर्दिष्ट map का उपयोग करती है जब तक कि सरणी का आधार प्रकार उपयोगकर्ता के परिभाषित प्रकार के map मेल नहीं खाता है, उस स्थिति में यह मानक मैपिंग का उपयोग करता है। विधि का यह संस्करण getResultSet या तो दिए गए प्रकार के नक्शे या मानक मानचित्रण का उपयोग करता है; यह कभी भी कनेक्शन से जुड़े टाइप मैप का उपयोग नहीं करता है।

परिणाम सेट में प्रत्येक पंक्ति तत्व के लिए एक पंक्ति होती है, जिसमें प्रत्येक पंक्ति में दो कॉलम होते हैं। दूसरा स्तंभ तत्व मान संग्रहीत करता है; पहला कॉलम उस तत्व के लिए इंडेक्स को स्टोर करता है (पहला एरे तत्व एलिमेंट 1 पर होने के साथ)। पंक्तियाँ सूचकांकों के क्रम के अनुसार आरोही क्रम में हैं।

पैरामीटर:
map - जावा प्रोग्रामिंग भाषा में कक्षाओं में SQL उपयोगकर्ता-परिभाषित प्रकारों की मैपिंग शामिल है
यह दिखाता है:
इस Array ऑब्जेक्ट द्वारा निर्दिष्ट सरणी में तत्वों में से प्रत्येक के लिए एक पंक्ति वाली एक ResultSet वस्तु, सूचकांक के आधार पर आरोही क्रम में पंक्तियों के साथ।
फेंकता:
SQLException - यदि सरणी तक पहुंचने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getResultSet

ResultSet getResultSet(long index,
                       int count)
                throws SQLException

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

परिणाम सेट में इस ऑब्जेक्ट द्वारा निर्दिष्ट SQL सरणी के प्रत्येक तत्व के लिए एक पंक्ति होती है, जिसमें पहली पंक्ति अनुक्रमणिका index में तत्व index । परिणाम सेट में सूचकांक के आधार पर आरोही क्रम में पंक्तियों को count लिए है। प्रत्येक पंक्ति में दो स्तंभ होते हैं: दूसरा स्तंभ तत्व मान संग्रहीत करता है; पहला कॉलम उस तत्व के लिए इंडेक्स को सरणी में संग्रहीत करता है।

पैरामीटर:
index - पुनः प्राप्त करने के लिए पहले तत्व का सरणी सूचकांक; पहला तत्व इंडेक्स 1 पर है
count - क्रमिक SQL सरणी तत्वों की संख्या को पुनः प्राप्त करने के लिए
यह दिखाता है:
अनुक्रमणिका index पर शुरू होने वाले इस Array ऑब्जेक्ट द्वारा निर्दिष्ट SQL सरणी के लगातार तत्वों की count करने के लिए एक ResultSet वस्तु।
फेंकता:
SQLException - यदि सरणी तक पहुंचने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getResultSet

ResultSet getResultSet(long index,
                       int count,
                       Map<String,Class<?>> map)
                throws SQLException

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

परिणाम सेट में इस ऑब्जेक्ट द्वारा निर्दिष्ट SQL सरणी के प्रत्येक तत्व के लिए एक पंक्ति होती है, जिसमें पहली पंक्ति अनुक्रमणिका index में तत्व index । परिणाम सेट में सूचकांक के आधार पर आरोही क्रम में पंक्तियों को count लिए है। प्रत्येक पंक्ति में दो स्तंभ होते हैं: दूसरा स्तंभ तत्व मान संग्रहीत करता है; पहला कॉलम उस तत्व के लिए इंडेक्स को सरणी में संग्रहीत करता है।

पैरामीटर:
index - पुनः प्राप्त करने के लिए पहले तत्व का सरणी सूचकांक; पहला तत्व इंडेक्स 1 पर है
count - क्रमिक SQL सरणी तत्वों की संख्या को पुनः प्राप्त करने के लिए
map - Map ऑब्जेक्ट जिसमें SQL टाइप नाम की मैपिंग से लेकर जावा (tm) प्रोग्रामिंग लैंग्वेज तक की क्लास होती हैं
यह दिखाता है:
अनुक्रमणिका index पर शुरू होने वाले इस Array ऑब्जेक्ट द्वारा निर्दिष्ट SQL सरणी के लगातार तत्वों की count करने के लिए एक ResultSet वस्तु।
फेंकता:
SQLException - यदि सरणी तक पहुंचने का प्रयास करते समय कोई त्रुटि होती है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

मुक्त

void free()
   throws SQLException

यह विधि Array ऑब्जेक्ट को मुक्त करती है और संसाधनों को रखती है जो इसे रखती है। free विधि कहा जाता है एक बार वस्तु अमान्य है।

free में बुलाए जाने के बाद, free के अलावा किसी अन्य विधि को लागू करने के किसी भी प्रयास के परिणामस्वरूप एक SQLException को फेंक दिया जाएगा। यदि free को कई बार कहा जाता है, तो free में आने वाली कॉल को नो-ऑप माना जाता है।

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