OpenJDK 8 - Blob

इंटरफ़ेस बूँद




openjdk

इंटरफ़ेस बूँद

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

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

इंटरफेस में तरीके ResultSet , CallableStatement , और getBlob , जैसे getBlob और setBlob प्रोग्रामर को SQL BLOB मान एक्सेस करने की अनुमति देते हैं। Blob इंटरफ़ेस SQL BLOB (बाइनरी लार्ज ऑब्जेक्ट) मान की लंबाई प्राप्त करने के लिए तरीके प्रदान करता है, क्लाइंट पर एक BLOB मूल्य को मटेरियल करने के लिए और एक BLOB मान के भीतर बाइट्स के पैटर्न की स्थिति निर्धारित करने के लिए। इसके अलावा, इस इंटरफ़ेस में BLOB मान को अपडेट करने के तरीके हैं।

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

जबसे:
1.2

तरीके

लंबाई

long length()
     throws SQLException

इस Blob ऑब्जेक्ट द्वारा निर्दिष्ट BLOB मान में बाइट्स की संख्या लौटाता है।

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

getBytes

byte[] getBytes(long pos,
                int length)
         throws SQLException

BLOB भाग के रूप में, इस Blob ऑब्जेक्ट को दर्शाता है, जो कि सभी BLOB मूल्‍य का भाग BLOB । इस byte सरणी में स्थिति pos पर शुरू होने वाली लगातार बाइट्स length होती है।

पैरामीटर:
pos - निकाले जाने वाले BLOB मूल्य में पहली बाइट की क्रमिक स्थिति; पहली बाइट स्थिति 1 पर है
length - नकल करने के लिए लगातार बाइट्स की संख्या; लंबाई के लिए मान 0 या अधिक होना चाहिए
यह दिखाता है:
एक बाइट सरणी जिसमें इस Blob ऑब्जेक्ट द्वारा निर्दिष्ट BLOB मूल्य से लगातार बाइट्स तक की स्थिति में बाइट के साथ शुरू होता है
फेंकता:
SQLException - अगर BLOB मान तक पहुँचने में कोई त्रुटि है; यदि पोज़ 1 से कम है या लंबाई 0 से कम है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2
यह भी देखें:
setBytes(long, byte[])

getBinaryStream

InputStream getBinaryStream()
                     throws SQLException

इस Blob उदाहरण द्वारा स्ट्रीम के रूप में निर्दिष्ट BLOB मान को पुनः प्राप्त करता है।

यह दिखाता है:
BLOB डेटा युक्त स्ट्रीम
फेंकता:
SQLException - अगर BLOB मान तक पहुँचने में कोई त्रुटि है
SQLFeatureNotSupportedException - यदि JDBC ड्राइवर इस विधि का समर्थन नहीं करता है
जबसे:
1.2
यह भी देखें:
setBinaryStream(long)

पद

long position(byte[] pattern,
              long start)
       throws SQLException

उस बाइट की स्थिति को पुनः प्राप्त करता है जिस पर निर्दिष्ट बाइट सरणी pattern BLOB मान के भीतर शुरू होता है जो इस Blob ऑब्जेक्ट का प्रतिनिधित्व करता है। pattern की खोज स्थिति start होने पर start

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

पद

long position(Blob pattern,
              long start)
       throws SQLException

इस Blob ऑब्जेक्ट द्वारा निर्दिष्ट BLOB मूल्य में बाइट स्थिति को पुनः प्राप्त करता है जिस पर pattern शुरू होता है। स्थिति start पर खोज शुरू होती है।

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

setBytes

int setBytes(long pos,
             byte[] bytes)
      throws SQLException

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

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

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

setBytes

int setBytes(long pos,
             byte[] bytes,
             int offset,
             int len)
      throws SQLException

दिए गए byte सरणी के सभी या भाग को BLOB मान में लिखा जाता है कि यह Blob ऑब्जेक्ट प्रतिनिधित्व करता है और लिखी गई बाइट्स की संख्या को लौटाता है। लेखन BLOB मूल्य में स्थिति pos में शुरू होता है; दिए गए बाइट सरणी से len बाइट्स लिखे गए हैं। बाइट्स की सरणी मौजूदा pos में ओवर बाइट को अधिलेखित कर देगी Blob ऑब्जेक्ट में स्थिति pos शुरू होती है। यदि बाइट्स की सरणी लिखते समय Blob वैल्यू का अंत हो जाता है, तो अतिरिक्त बाइट्स को समायोजित करने के लिए Blob वैल्यू की लंबाई बढ़ जाएगी।

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

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

setBinaryStream

OutputStream setBinaryStream(long pos)
                      throws SQLException

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

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

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

काट-छांट

void truncate(long len)
       throws SQLException

BLOB मान को BLOB कि यह Blob ऑब्जेक्ट लंबाई में len बाइट्स का प्रतिनिधित्व करता है।

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

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

मुक्त

void free()
   throws SQLException

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

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

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

getBinaryStream

InputStream getBinaryStream(long pos,
                            long length)
                     throws SQLException

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

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