Path: blob/master/src/java.sql/share/classes/java/sql/NClob.java
41153 views
/*1* Copyright (c) 2005, 2020, Oracle and/or its affiliates. All rights reserved.2* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.3*4* This code is free software; you can redistribute it and/or modify it5* under the terms of the GNU General Public License version 2 only, as6* published by the Free Software Foundation. Oracle designates this7* particular file as subject to the "Classpath" exception as provided8* by Oracle in the LICENSE file that accompanied this code.9*10* This code is distributed in the hope that it will be useful, but WITHOUT11* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or12* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License13* version 2 for more details (a copy is included in the LICENSE file that14* accompanied this code).15*16* You should have received a copy of the GNU General Public License version17* 2 along with this work; if not, write to the Free Software Foundation,18* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.19*20* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA21* or visit www.oracle.com if you need additional information or have any22* questions.23*/2425package java.sql;2627/**28* The mapping in the Java programming language29* for the SQL {@code NCLOB} type.30* An SQL {@code NCLOB} is a built-in type31* that stores a Character Large Object using the National Character Set32* as a column value in a row of a database table.33* <P>The {@code NClob} interface extends the {@code Clob} interface34* which provides methods for getting the35* length of an SQL {@code NCLOB} value,36* for materializing a {@code NCLOB} value on the client, and for37* searching for a substring or {@code NCLOB} object within a38* {@code NCLOB} value. A {@code NClob} object, just like a {@code Clob} object, is valid for the duration39* of the transaction in which it was created.40* Methods in the interfaces {@link ResultSet},41* {@link CallableStatement}, and {@link PreparedStatement}, such as42* {@code getNClob} and {@code setNClob} allow a programmer to43* access an SQL {@code NCLOB} value. In addition, this interface44* has methods for updating a {@code NCLOB} value.45* <p>46* All methods on the {@code NClob} interface must be fully implemented if the47* JDBC driver supports the data type.48*49* @since 1.650*/5152public interface NClob extends Clob { }535455