OpenJDK 8 - Clob

इंटरफ़ेस क्लो




openjdk

इंटरफ़ेस क्लो

सभी ज्ञात उपप्रकारों:
NClob
सभी ज्ञात कार्यान्वयन कक्षाएं:
SerialClob
public interface Clob

SQL CLOB प्रकार के लिए जावा ™ प्रोग्रामिंग भाषा में मैपिंग। SQL CLOB एक अंतर्निहित प्रकार है जो डेटाबेस तालिका की एक पंक्ति में स्तंभ मान के रूप में एक वर्ण बड़े ऑब्जेक्ट को संग्रहीत करता है। डिफ़ॉल्ट रूप से ड्राइवर्स एक SQL locator(CLOB) का उपयोग करके एक Clob ऑब्जेक्ट को लागू करते हैं, जिसका अर्थ है कि एक Clob ऑब्जेक्ट में डेटा के बजाय SQL CLOB डेटा के लिए एक लॉजिकल पॉइंटर होता है। एक Clob ऑब्जेक्ट उस लेनदेन की अवधि के लिए मान्य है जिसमें यह बनाया गया था।

Clob इंटरफ़ेस SQL CLOB (कैरेक्टर लार्ज ऑब्जेक्ट) मान की लंबाई प्राप्त करने के लिए, क्लाइंट पर एक CLOB मूल्य को मटेरियल करने के लिए, और एक CLOB मान के लिए एक विकल्प या CLOB ऑब्जेक्ट की खोज के लिए तरीके प्रदान करता है। इंटरफेस में तरीके ResultSet , CallableStatement , और getClob , जैसे getClob और setClob प्रोग्रामर को SQL CLOB मान एक्सेस करने की अनुमति देते हैं। इसके अलावा, इस इंटरफ़ेस में CLOB मान अपडेट करने के तरीके हैं।

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

जबसे:
1.2

तरीके

लंबाई

long length()
     throws SQLException

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

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

getSubString

String getSubString(long pos,
                    int length)
             throws SQLException

इस Clob ऑब्जेक्ट द्वारा निर्दिष्ट Clob मान में निर्दिष्ट Clob एक प्रति Clob है। विकल्प की स्थिति pos में शुरू होती है और इसमें लगातार वर्णों length होती है।

पैरामीटर:
pos - निकाले जाने वाले सबस्ट्रिंग का पहला चरित्र। पहला चरित्र स्थिति 1 पर है।
length - कॉपी किए जाने वाले लगातार पात्रों की संख्या; लंबाई के लिए मान 0 या अधिक होना चाहिए
यह दिखाता है:
एक String जो इस Clob ऑब्जेक्ट द्वारा निर्दिष्ट Clob मान में निर्दिष्ट Clob है
फेंकता:
SQLException - यदि CLOB मान तक पहुँचने में कोई त्रुटि है; यदि पोज़ 1 से कम है या लंबाई 0 से कम है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

getCharacterStream

Reader getCharacterStream()
                   throws SQLException

इस Clob ऑब्जेक्ट द्वारा निर्दिष्ट Clob मान को java.io.Reader ऑब्जेक्ट (या वर्णों की एक धारा के रूप में) के रूप में पुनर्प्राप्त करता है।

यह दिखाता है:
एक java.io.Reader ऑब्जेक्ट जिसमें CLOB डेटा है
फेंकता:
SQLException - यदि CLOB मान तक पहुँचने में कोई त्रुटि है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2
यह भी देखें:
setCharacterStream(long)

getAsciiStream

InputStream getAsciiStream()
                    throws SQLException

इस Clob ऑब्जेक्ट द्वारा निर्दिष्ट Clob मान को Clob स्ट्रीम के रूप में Clob करता है।

यह दिखाता है:
java.io.InputStream ऑब्जेक्ट जिसमें CLOB डेटा है
फेंकता:
SQLException - यदि CLOB मान तक पहुँचने में कोई त्रुटि है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2
यह भी देखें:
setAsciiStream(long)

पद

long position(String searchstr,
              long start)
       throws SQLException

इस Clob ऑब्जेक्ट द्वारा दर्शाए गए SQL Clob मान में निर्दिष्ट स्थान पर वह स्थान निर्दिष्ट करता है जिस पर निर्दिष्ट सबस्ट्रिंग searchstr दिखाई देती है। स्थिति start पर खोज शुरू होती है।

पैरामीटर:
searchstr - जिसके विकल्प को खोजना है
start - खोज शुरू करने के लिए जिस पर स्थिति; पहली स्थिति 1 है
यह दिखाता है:
वह स्थान जिस पर सबस्ट्रिंग प्रकट होता है या -1 मौजूद नहीं होने पर; पहली स्थिति 1 है
फेंकता:
SQLException - अगर CLOB मान तक पहुँचने में कोई त्रुटि है या यदि स्थिति 1 से कम है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

पद

long position(Clob searchstr,
              long start)
       throws SQLException

उस वर्ण स्थिति को पुनः प्राप्त करता है जिस पर इस Clob ऑब्जेक्ट में निर्दिष्ट Clob ऑब्जेक्ट searchstr दिखाई देती है। स्थिति start पर खोज शुरू होती है।

पैरामीटर:
searchstr - Clob ऑब्जेक्ट जिसको खोजना है
start - खोज शुरू करने के लिए जिस पर स्थिति; पहली स्थिति 1 है
यह दिखाता है:
वह स्थिति जिस पर Clob ऑब्जेक्ट दिखाई देता है या -1 यदि वह मौजूद नहीं है; पहली स्थिति 1 है
फेंकता:
SQLException - यदि CLOB मान तक पहुँचने में कोई त्रुटि है या यदि प्रारंभ 1 से कम है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2

setString

int setString(long pos,
              String str)
       throws SQLException

दिए गए जावा String को Clob मान में Clob कि यह Clob ऑब्जेक्ट Clob नामित होता है। स्ट्रिंग स्थिति pos शुरू होने वाले Clob ऑब्जेक्ट में मौजूदा वर्णों को अधिलेखित कर देगा। यदि दिए गए तार को लिखते समय Clob मान का अंत हो जाता है, तो अतिरिक्त वर्णों को समायोजित करने के लिए Clob मान की लंबाई बढ़ा दी जाएगी।

नोट: यदि pos लिए निर्दिष्ट मूल्य अधिक है, तो CLOB मान की लंबाई + 1 है तो व्यवहार अपरिभाषित है। कुछ JDBC ड्राइवर SQLException को फेंक सकते हैं जबकि अन्य ड्राइवर इस ऑपरेशन का समर्थन कर सकते हैं।

पैरामीटर:
pos - वह स्थिति जिस पर Clob मान लिखना शुरू करना है जो इस Clob ऑब्जेक्ट का प्रतिनिधित्व करता है; पहली स्थिति 1 है
str - स्ट्रिंग को Clob मान में लिखा जाना चाहिए जो यह Clob नामित करता है
यह दिखाता है:
लिखे गए पात्रों की संख्या
फेंकता:
SQLException - अगर CLOB मान तक पहुँचने में कोई त्रुटि है या यदि स्थिति 1 से कम है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.4

setString

int setString(long pos,
              String str,
              int offset,
              int len)
       throws SQLException

वर्ण के वर्णों को Clob करता है, वर्ण offset पर शुरू होता है, Clob मान के लिए जो यह Clob दर्शाता है। स्ट्रिंग स्थिति pos शुरू होने वाले Clob ऑब्जेक्ट में मौजूदा वर्णों को अधिलेखित कर देगा। यदि दिए गए तार को लिखते समय Clob मान का अंत हो जाता है, तो अतिरिक्त वर्णों को समायोजित करने के लिए Clob मान की लंबाई बढ़ा दी जाएगी।

नोट: यदि pos लिए निर्दिष्ट मूल्य अधिक है, तो CLOB मान की लंबाई + 1 है तो व्यवहार अपरिभाषित है। कुछ JDBC ड्राइवर SQLException को फेंक सकते हैं जबकि अन्य ड्राइवर इस ऑपरेशन का समर्थन कर सकते हैं।

पैरामीटर:
pos - इस CLOB ऑब्जेक्ट पर लिखना शुरू करने की स्थिति; पहली स्थिति 1 है
str - स्ट्रिंग को Clob मान में लिखा जाना है जो यह Clob ऑब्जेक्ट दर्शाता है
offset - लिखे जाने वाले वर्णों को पढ़ना शुरू करने के लिए str द ऑफसेट
len - लिखे जाने वाले पात्रों की संख्या
यह दिखाता है:
लिखे गए पात्रों की संख्या
फेंकता:
SQLException - अगर CLOB मान तक पहुँचने में कोई त्रुटि है या यदि स्थिति 1 से कम है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.4

setAsciiStream

OutputStream setAsciiStream(long pos)
                     throws SQLException

स्थिति को pos शुरू करते हुए, Clob मूल्य का प्रतिनिधित्व करने के लिए Clob अक्षर लिखने के लिए एक धारा का उपयोग किया जाता है। स्ट्रीम को लिखे गए वर्ण स्थिति pos शुरू होने वाले Clob ऑब्जेक्ट में मौजूदा वर्णों को अधिलेखित कर देंगे। यदि वर्ण को धारा में लिखते समय Clob मान का अंत हो जाता है, तो अतिरिक्त वर्णों को समायोजित करने के लिए Clob मान की लंबाई बढ़ जाएगी।

नोट: यदि pos लिए निर्दिष्ट मूल्य अधिक है, तो CLOB मान की लंबाई + 1 है तो व्यवहार अपरिभाषित है। कुछ JDBC ड्राइवर SQLException को फेंक सकते हैं जबकि अन्य ड्राइवर इस ऑपरेशन का समर्थन कर सकते हैं।

पैरामीटर:
pos - इस CLOB ऑब्जेक्ट पर लिखना शुरू करने की स्थिति; पहली स्थिति 1 है
यह दिखाता है:
जिस धारा में ASCII एन्कोडेड अक्षर लिखे जा सकते हैं
फेंकता:
SQLException - अगर CLOB मान तक पहुँचने में कोई त्रुटि है या यदि स्थिति 1 से कम है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.4
यह भी देखें:
getAsciiStream()

setCharacterStream

Writer setCharacterStream(long pos)
                   throws SQLException

Clob वैल्यू के लिए यूनिकोड वर्णों की एक धारा लिखने के लिए उपयोग की जाने वाली एक धारा को पुनः प्राप्त करता है जो यह Clob ऑब्जेक्ट Clob प्रस्तुत करता है। स्ट्रीम को लिखे गए वर्ण स्थिति pos शुरू होने वाले Clob ऑब्जेक्ट में मौजूदा वर्णों को अधिलेखित कर देंगे। यदि वर्ण को धारा में लिखते समय Clob मान का अंत हो जाता है, तो अतिरिक्त वर्णों को समायोजित करने के लिए Clob मान की लंबाई बढ़ जाएगी।

नोट: यदि pos लिए निर्दिष्ट मूल्य अधिक है, तो CLOB मान की लंबाई + 1 है तो व्यवहार अपरिभाषित है। कुछ JDBC ड्राइवर SQLException को फेंक सकते हैं जबकि अन्य ड्राइवर इस ऑपरेशन का समर्थन कर सकते हैं।

पैरामीटर:
pos - वह स्थिति जिस पर CLOB मान लिखना शुरू करना; पहली स्थिति 1 है
यह दिखाता है:
एक धारा जिसमें यूनिकोड एन्कोडेड वर्ण लिखे जा सकते हैं
फेंकता:
SQLException - अगर CLOB मान तक पहुँचने में कोई त्रुटि है या यदि स्थिति 1 से कम है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.4
यह भी देखें:
getCharacterStream()

काट-छांट

void truncate(long len)
       throws SQLException

Clob मान Clob जो इस Clob को len वर्णों की लंबाई के लिए नामित करता है।

नोट: यदि pos लिए निर्दिष्ट मूल्य अधिक है, तो CLOB मान की लंबाई + 1 है तो व्यवहार अपरिभाषित है। कुछ JDBC ड्राइवर SQLException को फेंक सकते हैं जबकि अन्य ड्राइवर इस ऑपरेशन का समर्थन कर सकते हैं।

पैरामीटर:
len - लंबाई, वर्णों में, जिसमें CLOB मान को छोटा किया जाना चाहिए
फेंकता:
SQLException - यदि CLOB मान तक पहुँचने में कोई त्रुटि है या यदि लेन 0 से कम है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.4

मुक्त

void free()
   throws SQLException

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

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

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

getCharacterStream

Reader getCharacterStream(long pos,
                          long length)
                   throws SQLException

एक Reader ऑब्जेक्ट लौटाता है जिसमें एक आंशिक Clob मान होता है, जो पॉज़ द्वारा निर्दिष्ट चरित्र से शुरू होता है, जो लंबाई में लंबाई वर्ण होता है।

पैरामीटर:
pos - आंशिक मूल्य के पहले चरित्र को ऑफसेट किया जा सकता है। क्लोब में पहला चरित्र स्थिति 1 पर है।
length - आंशिक मूल्य के पात्रों में लंबाई को पुनः प्राप्त किया जाना है।
यह दिखाता है:
Reader जिसके माध्यम से आंशिक Clob मूल्य पढ़ा जा सकता है।
फेंकता:
SQLException - अगर पॉज़ 1 से कम है या अगर Clob में वर्णों की संख्या से अधिक है या यदि Clob में वर्णों की संख्या से अधिक है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.6