/* * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * * Other licenses: * ----------------------------------------------------------------------------- * Commercial licenses for this work are available. These replace the above * ASL 2.0 and offer limited warranties, support, maintenance, and commercial * database integrations. * * For more information, please visit: http://www.jooq.org/licenses * * * * * * * * * * * * * */ package org.jooq.impl; import java.util.stream.Stream; import org.jooq.Binding; import org.jooq.Catalog; import org.jooq.Clause; import org.jooq.Context; import org.jooq.Converter; import org.jooq.DataType; import org.jooq.Field; import org.jooq.Name; import org.jooq.Package; import org.jooq.Record; import org.jooq.Row; import org.jooq.Schema; import org.jooq.UDT; import org.jooq.UDTField; import org.jooq.UDTRecord; /** * A common base type for UDT's * <p> * This type is for JOOQ INTERNAL USE only. Do not reference directly * * @author Lukas Eder */ public class UDTImpl<R extends UDTRecord<R>> extends AbstractQueryPart implements UDT<R> { private static final long serialVersionUID = -2208672099190913126L; private final Schema schema; private final String name; private final Fields<R> fields; private final Package pkg; private transient DataType<R> type; public UDTImpl(String name, Schema schema) { this(name, schema, null); } public UDTImpl(String name, Schema schema, Package pkg) { this.fields = new Fields<R>(); this.name = name; this.schema = schema; this.pkg = pkg; } @Override public final Catalog getCatalog() { return getSchema() == null ? null : getSchema().getCatalog(); } @Override public /* non-final */ Schema getSchema() { return schema; } @Override public final Package getPackage() { return pkg; } @Override public final String getName() { return name; } @SuppressWarnings({ "rawtypes" }) @Override public final Row fieldsRow() { return new RowImpl(fields); } @Override public final Stream<Field<?>> fieldStream() { return Stream.of(fields()); } @Override public final <T> Field<T> field(Field<T> field) { return fieldsRow().field(field); } @Override public final Field<?> field(String string) { return fieldsRow().field(string); } @Override public final Field<?> field(Name fieldName) { return fieldsRow().field(fieldName); } @Override public final Field<?> field(int index) { return fieldsRow().field(index); } @Override public final Field<?>[] fields() { return fieldsRow().fields(); } @Override public final Field<?>[] fields(Field<?>... f) { return fieldsRow().fields(f); } @Override public final Field<?>[] fields(String... fieldNames) { return fieldsRow().fields(fieldNames); } @Override public final Field<?>[] fields(Name... fieldNames) { return fieldsRow().fields(fieldNames); } @Override public final Field<?>[] fields(int... fieldIndexes) { return fieldsRow().fields(fieldIndexes); } final Fields<R> fields0() { return fields; } /** * Subclasses must override this method if they use the generic type * parameter <R> for other types than {@link Record} */ @Override public Class<R> getRecordType() { throw new UnsupportedOperationException(); } @Override public final boolean isSQLUsable() { return pkg == null; } @Override public final R newRecord() { return DSL.using(new DefaultConfiguration()).newRecord(this); } @Override public final DataType<R> getDataType() { if (type == null) { type = new UDTDataType<R>(this); } return type; } @Override public final void accept(Context<?> ctx) { Schema mappedSchema = Tools.getMappedSchema(ctx.configuration(), getSchema()); if (mappedSchema != null) { ctx.visit(mappedSchema); ctx.sql('.'); } if (getPackage() != null) { ctx.visit(getPackage()); ctx.sql('.'); } ctx.visit(DSL.name(getName())); } @Override public final Clause[] clauses(Context<?> ctx) { return null; } /** * Subclasses may call this method to create {@link UDTField} objects that * are linked to this table. * * @param name The name of the field (case-sensitive!) * @param type The data type of the field */ protected static final <R extends UDTRecord<R>, T> UDTField<R, T> createField(String name, DataType<T> type, UDT<R> udt) { return createField(name, type, udt, "", null, null); } /** * Subclasses may call this method to create {@link UDTField} objects that * are linked to this table. * * @param name The name of the field (case-sensitive!) * @param type The data type of the field */ protected static final <R extends UDTRecord<R>, T> UDTField<R, T> createField(String name, DataType<T> type, UDT<R> udt, String comment) { return createField(name, type, udt, comment, null, null); } /** * Subclasses may call this method to create {@link UDTField} objects that * are linked to this table. * * @param name The name of the field (case-sensitive!) * @param type The data type of the field */ protected static final <R extends UDTRecord<R>, T, U> UDTField<R, U> createField(String name, DataType<T> type, UDT<R> udt, String comment, Converter<T, U> converter) { return createField(name, type, udt, comment, converter, null); } /** * Subclasses may call this method to create {@link UDTField} objects that * are linked to this table. * * @param name The name of the field (case-sensitive!) * @param type The data type of the field */ protected static final <R extends UDTRecord<R>, T, U> UDTField<R, U> createField(String name, DataType<T> type, UDT<R> udt, String comment, Binding<T, U> binding) { return createField(name, type, udt, comment, null, binding); } /** * Subclasses may call this method to create {@link UDTField} objects that * are linked to this table. * * @param name The name of the field (case-sensitive!) * @param type The data type of the field */ @SuppressWarnings("unchecked") protected static final <R extends UDTRecord<R>, T, X, U> UDTField<R, U> createField(String name, DataType<T> type, UDT<R> udt, String comment, Converter<X, U> converter, Binding<T, X> binding) { final Binding<T, U> actualBinding = DefaultBinding.newBinding(converter, type, binding); final DataType<U> actualType = converter == null && binding == null ? (DataType<U>) type : type.asConvertedDataType(actualBinding); // [#5999] TODO: Allow for user-defined Names final UDTFieldImpl<R, U> udtField = new UDTFieldImpl<R, U>(DSL.name(name), actualType, udt, comment, actualBinding); return udtField; } // ------------------------------------------------------------------------ // XXX: Object API // ------------------------------------------------------------------------ @Override public int hashCode() { // [#1938] This is a much more efficient hashCode() implementation // compared to that of standard QueryParts return name.hashCode(); } }