15346133148

Committed 30 May 2025 11:50AM UTC coverage: 70.397% (+0.1%) from 70.298%

Build # 15346133148

Build Type

push

github

Committed by

torand

Commit Message

chore: test javadoc publish

Run Details

235 of 420 branches covered (55.95%)

Branch coverage included in aggregate %.

1237 of 1671 relevant lines covered (74.03%)

3.9 hits per line

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

87.88

/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 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.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.TRUNCATE_TABLE;
import static io.github.torand.fastersql.util.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));
    }

    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 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 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> 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 java.util.EnumSet;
19	import java.util.List;
20	import java.util.Optional;
21
22	import static io.github.torand.fastersql.dialect.Capability.CONCAT_OPERATOR;
23	import static io.github.torand.fastersql.dialect.Capability.LIMIT_OFFSET;
24	import static io.github.torand.fastersql.dialect.Capability.NULL_ORDERING;
25	import static io.github.torand.fastersql.dialect.Capability.SELECT_FOR_UPDATE;
26	import static io.github.torand.fastersql.dialect.Capability.TRUNCATE_TABLE;
27	import static io.github.torand.fastersql.util.lang.StringHelper.generate;
28
29	/**
30	* Defines the <a href="https://docs.oracle.com/en/database/oracle/oracle-database/21/sqlrf/">Oracle</a> SQL dialect.
31	*/
32	public class OracleDialect implements Dialect {
33	private final EnumSet<Capability> supportedCaps;
34
35	/**
36	* Creates an Oracle {@link Dialect} implementation.
37	*/
38	public OracleDialect() {
39	this(EnumSet.of(LIMIT_OFFSET, CONCAT_OPERATOR, NULL_ORDERING, SELECT_FOR_UPDATE, TRUNCATE_TABLE));	8✔
40	}	1✔
41
42	private OracleDialect(EnumSet<Capability> capabilities) {	2✔
43	this.supportedCaps = EnumSet.copyOf(capabilities);	4✔
44	}	1✔
45
46	@Override
47	public String getProductName() {
48	return "Oracle";	2✔
49	}
50
51	@Override
52	public boolean offsetBeforeLimit() {
53	return true;	2✔
54	}
55
56	/**
57	* Row offset clause is supported from Oracle 12c onwards
58	*/
59	@Override
60	public Optional<String> formatRowOffsetClause() {
61	return Optional.of("offset ? rows");	3✔
62	}
63
64	/**
65	* Row limit clause is supported from Oracle 12c onwards
66	*/
67	@Override
68	public Optional<String> formatRowLimitClause() {
69	return Optional.of("fetch next ? rows only");	3✔
70	}
71
72	@Override
73	public Optional<String> formatRowNumLiteral() {
74	return Optional.of("rownum");	3✔
75	}
76
77	@Override
78	public String formatToNumberFunction(String operand, int precision, int scale) {
79	StringBuilder mask = new StringBuilder();	4✔
80	if (precision-scale > 0) {	4!
81	mask.append(generate("9", precision-scale));	8✔
82	}
83	if (scale > 0) {	2!
84	mask.append(".").append(generate("9", scale));	×
85	}
86
87	return "to_number(" + operand + ", '" + mask + "')";	5✔
88	}
89
90	@Override
91	public String formatToCharFunction(String operand, String format) {
92	return "to_char(" + operand + ", " + format + ")";	4✔
93	}
94
95	@Override
96	public String formatSubstringFunction(String operand, int startPos, int length) {
97	return "substr(" + operand + ", " + startPos + ", " + length + ")";	5✔
98	}
99
100	@Override
101	public String formatConcatFunction(List<String> operands) {
102	throw new UnsupportedOperationException("Oracle does not support the concat() function (use the concat infix operator instead)");	×
103	}
104
105	@Override
106	public String formatLengthFunction(String operand) {
107	return "length(" + operand + ")";	3✔
108	}
109
110	@Override
111	public String formatCeilFunction(String operand) {
112	return "ceil(" + operand + ")";	3✔
113	}
114
115	@Override
116	public String formatRoundFunction(String operand) {
117	return "round(" + operand + ")";	3✔
118	}
119
120	@Override
121	public String formatModuloFunction(String divisor, String dividend) {
122	return "mod(" + divisor + ", " + dividend + ")";	4✔
123	}
124
125	@Override
126	public String formatCurrentDateFunction() {
127	return "current_date";	2✔
128	}
129
130	@Override
131	public Optional<String> getConcatOperator() {
132	return Optional.of("\|\|");	3✔
133	}
134
135	@Override
136	public boolean supports(Capability capability) {
137	return supportedCaps.contains(capability);	5✔
138	}
139
140	/**
141	* Enables emulating OFFSET and LIMIT constructs for older Oracle versions.
142	* Row offset and limit clauses are supported from Oracle 12c onwards.
143	* Invoke this method when using previous versions of Oracle, to simulate these clauses with subqueries.
144	* @return the modified dialect.
145	*/
146	public OracleDialect withLegacyRowLimiting() {
147	EnumSet<Capability> reducedCaps = EnumSet.copyOf(supportedCaps);	4✔
148	reducedCaps.remove(LIMIT_OFFSET);	4✔
149	return new OracleDialect(reducedCaps);	5✔
150	}
151	}

torand / FasterSQL / 15346133148

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