|
| 1 | +/*- |
| 2 | + * #%L |
| 3 | + * JSQLParser library |
| 4 | + * %% |
| 5 | + * Copyright (C) 2004 - 2026 JSQLParser |
| 6 | + * %% |
| 7 | + * Dual licensed under GNU LGPL 2.1 or Apache License 2.0 |
| 8 | + * #L% |
| 9 | + */ |
| 10 | +package net.sf.jsqlparser.statement.select; |
| 11 | + |
| 12 | +import static org.junit.jupiter.api.Assertions.assertEquals; |
| 13 | +import static org.junit.jupiter.api.Assertions.assertFalse; |
| 14 | +import static org.junit.jupiter.api.Assertions.assertTrue; |
| 15 | +import java.util.Set; |
| 16 | +import net.sf.jsqlparser.expression.LongValue; |
| 17 | +import net.sf.jsqlparser.parser.CCJSqlParserUtil; |
| 18 | +import net.sf.jsqlparser.parser.feature.Feature; |
| 19 | +import net.sf.jsqlparser.test.TestUtils; |
| 20 | +import net.sf.jsqlparser.util.TablesNamesFinder; |
| 21 | +import net.sf.jsqlparser.util.deparser.ExpressionDeParser; |
| 22 | +import net.sf.jsqlparser.util.deparser.SelectDeParser; |
| 23 | +import net.sf.jsqlparser.util.validation.ValidationTestAsserts; |
| 24 | +import net.sf.jsqlparser.util.validation.feature.FeaturesAllowed; |
| 25 | +import org.junit.jupiter.api.Test; |
| 26 | +import org.junit.jupiter.params.ParameterizedTest; |
| 27 | +import org.junit.jupiter.params.provider.ValueSource; |
| 28 | + |
| 29 | +class AsOfJoinTest extends ValidationTestAsserts { |
| 30 | + @ParameterizedTest |
| 31 | + @ValueSource(strings = {"ASOF JOIN", "ASOF INNER JOIN", "ASOF LEFT JOIN", |
| 32 | + "ASOF LEFT OUTER JOIN", "ASOF RIGHT JOIN", "ASOF FULL OUTER JOIN"}) |
| 33 | + void preservesAsOfAndOrdinaryJoinQualifiers(String joinType) throws Exception { |
| 34 | + String sql = "SELECT * FROM trades t " + joinType |
| 35 | + + " prices p ON t.symbol = p.symbol AND t.ts >= p.ts"; |
| 36 | + PlainSelect select = (PlainSelect) TestUtils.assertSqlCanBeParsedAndDeparsed(sql); |
| 37 | + Join join = select.getJoins().get(0); |
| 38 | + assertTrue(join.isAsOf()); |
| 39 | + assertEquals(joinType.contains("LEFT"), join.isLeft()); |
| 40 | + assertEquals(joinType.contains("OUTER"), join.isOuter()); |
| 41 | + assertTrue(((PlainSelect) CCJSqlParserUtil.parse(select.toString())).getJoins().get(0) |
| 42 | + .isAsOf()); |
| 43 | + assertEquals(Set.of("trades", "prices"), TablesNamesFinder.findTables(sql)); |
| 44 | + } |
| 45 | + |
| 46 | + @ParameterizedTest |
| 47 | + @ValueSource(strings = { |
| 48 | + "SELECT * FROM trades ASOF JOIN prices USING (symbol, ts)", |
| 49 | + "SELECT * FROM trades ASOF /* nearest */ LEFT JOIN prices USING (symbol, ts)", |
| 50 | + "SELECT * FROM (SELECT * FROM trades) ASOF JOIN prices ON trades.ts >= prices.ts", |
| 51 | + "SELECT * FROM trades t ASOF JOIN prices p ON t.ts >= p.ts JOIN symbols s ON s.id = t.id", |
| 52 | + "FROM trades t |> ASOF JOIN prices p ON t.ts >= p.ts |> SELECT *"}) |
| 53 | + void worksWithoutAliasesAndWithinExistingJoinPaths(String sql) throws Exception { |
| 54 | + TestUtils.assertSqlCanBeParsedAndDeparsed(sql, true); |
| 55 | + } |
| 56 | + |
| 57 | + @Test |
| 58 | + void keepsUsingColumnsStructuredAndAllowsChangingTheJoinKind() throws Exception { |
| 59 | + PlainSelect select = (PlainSelect) CCJSqlParserUtil.parse( |
| 60 | + "SELECT * FROM trades ASOF LEFT JOIN prices USING (symbol, ts)"); |
| 61 | + Join join = select.getJoins().get(0); |
| 62 | + assertEquals("symbol", join.getUsingColumns().get(0).getColumnName()); |
| 63 | + assertEquals("ts", join.getUsingColumns().get(1).getColumnName()); |
| 64 | + join.setAsOf(false); |
| 65 | + assertEquals("SELECT * FROM trades LEFT JOIN prices USING (symbol, ts)", select.toString()); |
| 66 | + assertTrue(join.withAsOf(true).isAsOf()); |
| 67 | + } |
| 68 | + |
| 69 | + @Test |
| 70 | + void visitsPredicatesThroughTheConfiguredDeparser() throws Exception { |
| 71 | + PlainSelect select = (PlainSelect) CCJSqlParserUtil.parse( |
| 72 | + "SELECT * FROM trades t ASOF LEFT JOIN prices p ON t.ts >= p.ts + 1"); |
| 73 | + StringBuilder output = new StringBuilder(); |
| 74 | + int[] visits = {0}; |
| 75 | + ExpressionDeParser expressions = new ExpressionDeParser(null, output) { |
| 76 | + @Override |
| 77 | + public <S> StringBuilder visit(LongValue value, S context) { |
| 78 | + visits[0]++; |
| 79 | + return getBuilder().append(value.getValue() + 100); |
| 80 | + } |
| 81 | + }; |
| 82 | + SelectDeParser deparser = new SelectDeParser(expressions, output); |
| 83 | + expressions.setSelectVisitor(deparser); |
| 84 | + select.accept((SelectVisitor<StringBuilder>) deparser, null); |
| 85 | + assertEquals("SELECT * FROM trades t ASOF LEFT JOIN prices p ON t.ts >= p.ts + 101", |
| 86 | + output.toString()); |
| 87 | + assertEquals(1, visits[0]); |
| 88 | + assertTrue(select.toString().endsWith("p.ts + 1")); |
| 89 | + } |
| 90 | + |
| 91 | + @ParameterizedTest |
| 92 | + @ValueSource(strings = {"SELECT asof FROM trades", "SELECT * FROM asof", |
| 93 | + "SELECT * FROM trades asof WHERE asof.ts > 0", |
| 94 | + "SELECT * FROM trades AS asof JOIN prices p ON asof.ts = p.ts", |
| 95 | + "SELECT * FROM trades \"ASOF\" JOIN prices p ON \"ASOF\".ts = p.ts"}) |
| 96 | + void keepsAsOfUsableAsAnIdentifier(String sql) throws Exception { |
| 97 | + PlainSelect select = (PlainSelect) TestUtils.assertSqlCanBeParsedAndDeparsed(sql); |
| 98 | + if (select.getJoins() != null) { |
| 99 | + assertFalse(select.getJoins().get(0).isAsOf()); |
| 100 | + } |
| 101 | + } |
| 102 | + |
| 103 | + @Test |
| 104 | + void validatesTheAsOfFeatureAndPredicateExpressions() throws Exception { |
| 105 | + String sql = "SELECT * FROM trades t ASOF JOIN prices p ON t.ts >= p.ts"; |
| 106 | + validateNoErrors(sql, 1, FeaturesAllowed.SELECT); |
| 107 | + validateNotAllowed(sql, 1, 1, |
| 108 | + new FeaturesAllowed().add(FeaturesAllowed.SELECT).remove(Feature.joinAsOf), |
| 109 | + Feature.joinAsOf); |
| 110 | + validateNotAllowed(sql + " + ?", 1, 1, |
| 111 | + new FeaturesAllowed().add(FeaturesAllowed.SELECT).remove(Feature.jdbcParameter), |
| 112 | + Feature.jdbcParameter); |
| 113 | + } |
| 114 | +} |
0 commit comments