16990059345

Committed 15 Aug 2025 12:34PM UTC coverage: 66.782% (-6.6%) from 73.399%

Build # 16990059345

Build Type

push

github

Committed by

torand

Commit Message

chore: access central snapshots

Run Details

294 of 598 branches covered (49.16%)

Branch coverage included in aggregate %.

1638 of 2295 relevant lines covered (71.37%)

3.83 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

63.33

/src/main/java/io/github/torand/fastersql/dialect/OracleDialect.java

/*
 * Copyright (c) 2024-2025 Tore Eide Andersen
 *
 * 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.
 */
package io.github.torand.fastersql.dialect;

import io.github.torand.fastersql.function.singlerow.cast.DataType;
import io.github.torand.fastersql.setoperation.SetOperator;

import java.util.EnumSet;
import java.util.List;
import java.util.Optional;

import static io.github.torand.fastersql.dialect.Capability.CONCAT_OPERATOR;
import static io.github.torand.fastersql.dialect.Capability.FULL_OUTER_JOIN;
import static io.github.torand.fastersql.dialect.Capability.LIMIT_OFFSET;
import static io.github.torand.fastersql.dialect.Capability.NULL_ORDERING;
import static io.github.torand.fastersql.dialect.Capability.SELECT_FOR_UPDATE;
import static io.github.torand.fastersql.dialect.Capability.SET_OPERATION_PARENTHESES;
import static io.github.torand.fastersql.dialect.Capability.TRUNCATE_TABLE;
import static io.github.torand.javacommons.lang.StringHelper.generate;

/**
 * Defines the <a href="https://docs.oracle.com/en/database/oracle/oracle-database/21/sqlrf/">Oracle</a> SQL dialect.
 */
public class OracleDialect implements Dialect {
    private final EnumSet<Capability> supportedCaps;

    /**
     * Creates an Oracle {@link Dialect} implementation.
     */
    public OracleDialect() {
        this(EnumSet.of(LIMIT_OFFSET, CONCAT_OPERATOR, NULL_ORDERING, SELECT_FOR_UPDATE, TRUNCATE_TABLE, FULL_OUTER_JOIN, SET_OPERATION_PARENTHESES));
    }

    private OracleDialect(EnumSet<Capability> capabilities) {
        this.supportedCaps = EnumSet.copyOf(capabilities);
    }

    @Override
    public String getProductName() {
        return "Oracle";
    }

    @Override
    public boolean offsetBeforeLimit() {
        return true;
    }

    /**
     * Row offset clause is supported from Oracle 12c onwards
     */
    @Override
    public Optional<String> formatRowOffsetClause() {
        return Optional.of("offset ? rows");
    }

    /**
     * Row limit clause is supported from Oracle 12c onwards
     */
    @Override
    public Optional<String> formatRowLimitClause() {
        return Optional.of("fetch next ? rows only");
    }

    @Override
    public Optional<String> formatRowNumLiteral() {
        return Optional.of("rownum");
    }

    @Override
    public String formatSetOperator(SetOperator setOperator) {
        return setOperator == SetOperator.EXCEPT ? "minus" : setOperator.sql();
    }

    @Override
    public String formatToNumberFunction(String operand, int precision, int scale) {
        StringBuilder mask = new StringBuilder();
        if (precision-scale > 0) {
            mask.append(generate("9", precision-scale));
        }
        if (scale > 0) {
            mask.append(".").append(generate("9", scale));
        }

        return "to_number(" + operand + ", '" + mask + "')";
    }

    @Override
    public String formatToCharFunction(String operand, String format) {
        return "to_char(" + operand + ", " + format + ")";
    }

    @Override
    public String formatSubstringFunction(String operand, int startPos, int length) {
        return "substr(" + operand + ", " + startPos + ", " + length + ")";
    }

    @Override
    public String formatConcatFunction(List<String> operands) {
        throw new UnsupportedOperationException("Oracle does not support the concat() function (use the concat infix operator instead)");
    }

    @Override
    public String formatLengthFunction(String operand) {
        return "length(" + operand + ")";
    }

    @Override
    public String formatCeilFunction(String operand) {
        return "ceil(" + operand + ")";
    }

    @Override
    public String formatLnFunction(String operand) {
        return "ln(" + operand + ")";
    }

    @Override
    public String formatRoundFunction(String operand) {
        return "round(" + operand + ")";
    }

    @Override
    public String formatModuloFunction(String divisor, String dividend) {
        return "mod(" + divisor + ", " + dividend + ")";
    }

    @Override
    public String formatCurrentDateFunction() {
        return "current_date";
    }

    @Override
    public Optional<String> getDataType(DataType dataType) {
        // https://docs.oracle.com/en/database/oracle/oracle-database/19/sqlrf/Data-Types.html
        return Optional.ofNullable(switch(dataType.getIsoDataType()) {
            case BOOLEAN -> null;
            case CHAR -> "char";
            case VARCHAR -> "varchar2";
            case BIT -> null;
            case BIT_VARYING -> null;
            case NUMERIC, DECIMAL, INTEGER, SMALLINT -> "number";
            case FLOAT, DOUBLE_PRECISION, REAL -> "float";
            case DATE, TIME -> "date";
            case INTERVAL -> null;
            case CHARACTER_LARGE_OBJECT -> "clob";
            case BINARY_LARGE_OBJECT -> "blob";
        });
    }

    @Override
    public Optional<String> getConcatOperator() {
        return Optional.of("||");
    }

    @Override
    public boolean supports(Capability capability) {
        return supportedCaps.contains(capability);
    }

    /**
     * Enables emulating OFFSET and LIMIT constructs for older Oracle versions.
     * Row offset and limit clauses are supported from Oracle 12c onwards.
     * Invoke this method when using previous versions of Oracle, to simulate these clauses with subqueries.
     * @return the modified dialect.
     */
    public OracleDialect withLegacyRowLimiting() {
        EnumSet<Capability> reducedCaps = EnumSet.copyOf(supportedCaps);
        reducedCaps.remove(LIMIT_OFFSET);
        return new OracleDialect(reducedCaps);
    }
}

1	/*
2	* Copyright (c) 2024-2025 Tore Eide Andersen
3	*
4	* Licensed under the Apache License, Version 2.0 (the "License");
5	* you may not use this file except in compliance with the License.
6	* You may obtain a copy of the License at
7	*
8	* http://www.apache.org/licenses/LICENSE-2.0
9	*
10	* Unless required by applicable law or agreed to in writing, software
11	* distributed under the License is distributed on an "AS IS" BASIS,
12	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13	* See the License for the specific language governing permissions and
14	* limitations under the License.
15	*/
16	package io.github.torand.fastersql.dialect;
17
18	import io.github.torand.fastersql.function.singlerow.cast.DataType;
19	import io.github.torand.fastersql.setoperation.SetOperator;
20
21	import java.util.EnumSet;
22	import java.util.List;
23	import java.util.Optional;
24
25	import static io.github.torand.fastersql.dialect.Capability.CONCAT_OPERATOR;
26	import static io.github.torand.fastersql.dialect.Capability.FULL_OUTER_JOIN;
27	import static io.github.torand.fastersql.dialect.Capability.LIMIT_OFFSET;
28	import static io.github.torand.fastersql.dialect.Capability.NULL_ORDERING;
29	import static io.github.torand.fastersql.dialect.Capability.SELECT_FOR_UPDATE;
30	import static io.github.torand.fastersql.dialect.Capability.SET_OPERATION_PARENTHESES;
31	import static io.github.torand.fastersql.dialect.Capability.TRUNCATE_TABLE;
32	import static io.github.torand.javacommons.lang.StringHelper.generate;
33
34	/**
35	* Defines the <a href="https://docs.oracle.com/en/database/oracle/oracle-database/21/sqlrf/">Oracle</a> SQL dialect.
36	*/
37	public class OracleDialect implements Dialect {
38	private final EnumSet<Capability> supportedCaps;
39
40	/**
41	* Creates an Oracle {@link Dialect} implementation.
42	*/
43	public OracleDialect() {
44	this(EnumSet.of(LIMIT_OFFSET, CONCAT_OPERATOR, NULL_ORDERING, SELECT_FOR_UPDATE, TRUNCATE_TABLE, FULL_OUTER_JOIN, SET_OPERATION_PARENTHESES));	30✔
45	}	1✔
46
47	private OracleDialect(EnumSet<Capability> capabilities) {	2✔
48	this.supportedCaps = EnumSet.copyOf(capabilities);	4✔
49	}	1✔
50
51	@Override
52	public String getProductName() {
53	return "Oracle";	2✔
54	}
55
56	@Override
57	public boolean offsetBeforeLimit() {
58	return true;	2✔
59	}
60
61	/**
62	* Row offset clause is supported from Oracle 12c onwards
63	*/
64	@Override
65	public Optional<String> formatRowOffsetClause() {
66	return Optional.of("offset ? rows");	3✔
67	}
68
69	/**
70	* Row limit clause is supported from Oracle 12c onwards
71	*/
72	@Override
73	public Optional<String> formatRowLimitClause() {
74	return Optional.of("fetch next ? rows only");	3✔
75	}
76
77	@Override
78	public Optional<String> formatRowNumLiteral() {
79	return Optional.of("rownum");	3✔
80	}
81
82	@Override
83	public String formatSetOperator(SetOperator setOperator) {
84	return setOperator == SetOperator.EXCEPT ? "minus" : setOperator.sql();	8✔
85	}
86
87	@Override
88	public String formatToNumberFunction(String operand, int precision, int scale) {
89	StringBuilder mask = new StringBuilder();	4✔
90	if (precision-scale > 0) {	4!
91	mask.append(generate("9", precision-scale));	8✔
92	}
93	if (scale > 0) {	2!
94	mask.append(".").append(generate("9", scale));	×
95	}
96
97	return "to_number(" + operand + ", '" + mask + "')";	5✔
98	}
99
100	@Override
101	public String formatToCharFunction(String operand, String format) {
102	return "to_char(" + operand + ", " + format + ")";	4✔
103	}
104
105	@Override
106	public String formatSubstringFunction(String operand, int startPos, int length) {
107	return "substr(" + operand + ", " + startPos + ", " + length + ")";	5✔
108	}
109
110	@Override
111	public String formatConcatFunction(List<String> operands) {
112	throw new UnsupportedOperationException("Oracle does not support the concat() function (use the concat infix operator instead)");	×
113	}
114
115	@Override
116	public String formatLengthFunction(String operand) {
117	return "length(" + operand + ")";	3✔
118	}
119
120	@Override
121	public String formatCeilFunction(String operand) {
122	return "ceil(" + operand + ")";	3✔
123	}
124
125	@Override
126	public String formatLnFunction(String operand) {
127	return "ln(" + operand + ")";	3✔
128	}
129
130	@Override
131	public String formatRoundFunction(String operand) {
132	return "round(" + operand + ")";	3✔
133	}
134
135	@Override
136	public String formatModuloFunction(String divisor, String dividend) {
137	return "mod(" + divisor + ", " + dividend + ")";	4✔
138	}
139
140	@Override
141	public String formatCurrentDateFunction() {
142	return "current_date";	2✔
143	}
144
145	@Override
146	public Optional<String> getDataType(DataType dataType) {
147	// https://docs.oracle.com/en/database/oracle/oracle-database/19/sqlrf/Data-Types.html
148	return Optional.ofNullable(switch(dataType.getIsoDataType()) {	8!
149	case BOOLEAN -> null;	×
150	case CHAR -> "char";	×
151	case VARCHAR -> "varchar2";	2✔
152	case BIT -> null;	×
153	case BIT_VARYING -> null;	×
154	case NUMERIC, DECIMAL, INTEGER, SMALLINT -> "number";	2✔
155	case FLOAT, DOUBLE_PRECISION, REAL -> "float";	×
156	case DATE, TIME -> "date";	×
157	case INTERVAL -> null;	×
158	case CHARACTER_LARGE_OBJECT -> "clob";	×
159	case BINARY_LARGE_OBJECT -> "blob";	×
160	});
161	}
162
163	@Override
164	public Optional<String> getConcatOperator() {
165	return Optional.of("\|\|");	3✔
166	}
167
168	@Override
169	public boolean supports(Capability capability) {
170	return supportedCaps.contains(capability);	5✔
171	}
172
173	/**
174	* Enables emulating OFFSET and LIMIT constructs for older Oracle versions.
175	* Row offset and limit clauses are supported from Oracle 12c onwards.
176	* Invoke this method when using previous versions of Oracle, to simulate these clauses with subqueries.
177	* @return the modified dialect.
178	*/
179	public OracleDialect withLegacyRowLimiting() {
180	EnumSet<Capability> reducedCaps = EnumSet.copyOf(supportedCaps);	4✔
181	reducedCaps.remove(LIMIT_OFFSET);	4✔
182	return new OracleDialect(reducedCaps);	5✔
183	}
184	}

torand / FasterSQL / 16990059345

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous