2 * Copyright (c) 2010-2022 Contributors to the openHAB project
4 * See the NOTICE file(s) distributed with this work for additional
7 * This program and the accompanying materials are made available under the
8 * terms of the Eclipse Public License 2.0 which is available at
9 * http://www.eclipse.org/legal/epl-2.0
11 * SPDX-License-Identifier: EPL-2.0
13 package org.openhab.persistence.jdbc.db;
15 import static org.hamcrest.CoreMatchers.is;
16 import static org.hamcrest.MatcherAssert.assertThat;
17 import static org.junit.jupiter.api.Assertions.assertInstanceOf;
19 import java.time.LocalDateTime;
20 import java.time.ZoneId;
21 import java.time.ZonedDateTime;
22 import java.time.format.DateTimeFormatter;
24 import org.eclipse.jdt.annotation.NonNullByDefault;
25 import org.junit.jupiter.api.BeforeEach;
26 import org.junit.jupiter.api.Test;
27 import org.openhab.core.library.items.CallItem;
28 import org.openhab.core.library.items.ColorItem;
29 import org.openhab.core.library.items.ContactItem;
30 import org.openhab.core.library.items.DateTimeItem;
31 import org.openhab.core.library.items.DimmerItem;
32 import org.openhab.core.library.items.ImageItem;
33 import org.openhab.core.library.items.LocationItem;
34 import org.openhab.core.library.items.NumberItem;
35 import org.openhab.core.library.items.PlayerItem;
36 import org.openhab.core.library.items.RollershutterItem;
37 import org.openhab.core.library.items.StringItem;
38 import org.openhab.core.library.items.SwitchItem;
39 import org.openhab.core.library.types.DateTimeType;
40 import org.openhab.core.library.types.DecimalType;
41 import org.openhab.core.library.types.HSBType;
42 import org.openhab.core.library.types.OnOffType;
43 import org.openhab.core.library.types.OpenClosedType;
44 import org.openhab.core.library.types.PercentType;
45 import org.openhab.core.library.types.PlayPauseType;
46 import org.openhab.core.library.types.PointType;
47 import org.openhab.core.library.types.QuantityType;
48 import org.openhab.core.library.types.RawType;
49 import org.openhab.core.library.types.RewindFastforwardType;
50 import org.openhab.core.library.types.StringListType;
51 import org.openhab.core.library.types.StringType;
52 import org.openhab.core.library.unit.SIUnits;
53 import org.openhab.core.persistence.FilterCriteria;
54 import org.openhab.core.persistence.FilterCriteria.Ordering;
55 import org.openhab.core.types.State;
58 * Tests the {@link JdbcBaseDAO}.
60 * @author Christoph Weitkamp - Initial contribution
63 public class JdbcBaseDAOTest {
65 private static final String DATE_PATTERN = "yyyy-MM-dd'T'HH:mm:ss";
66 private static final DateTimeFormatter DATE_PARSER = DateTimeFormatter.ofPattern(DATE_PATTERN);
67 private static final ZoneId UTC_ZONE_ID = ZoneId.of("UTC");
68 private static final String DB_TABLE_NAME = "testitem";
70 private final JdbcBaseDAO jdbcBaseDAO = new JdbcBaseDAO();
71 private @NonNullByDefault({}) FilterCriteria filter;
75 filter = new FilterCriteria();
79 public void testObjectAsStateReturnsValidState() {
80 State decimalType = jdbcBaseDAO.objectAsState(new NumberItem("testNumberItem"), null, 7.3);
81 assertInstanceOf(DecimalType.class, decimalType);
82 assertThat(decimalType, is(DecimalType.valueOf("7.3")));
83 State quantityType = jdbcBaseDAO.objectAsState(new NumberItem("testNumberItem"), SIUnits.CELSIUS, 7.3);
84 assertInstanceOf(QuantityType.class, quantityType);
85 assertThat(quantityType, is(QuantityType.valueOf("7.3 °C")));
87 State dateTimeType = jdbcBaseDAO.objectAsState(new DateTimeItem("testDateTimeItem"), null,
88 java.sql.Timestamp.valueOf("2021-02-01 23:30:02.049"));
89 assertInstanceOf(DateTimeType.class, dateTimeType);
90 assertThat(dateTimeType, is(DateTimeType.valueOf("2021-02-01T23:30:02.049")));
92 State hsbType = jdbcBaseDAO.objectAsState(new ColorItem("testColorItem"), null, "184,100,52");
93 assertInstanceOf(HSBType.class, hsbType);
94 assertThat(hsbType, is(HSBType.valueOf("184,100,52")));
96 State percentType = jdbcBaseDAO.objectAsState(new DimmerItem("testDimmerItem"), null, 52);
97 assertInstanceOf(PercentType.class, percentType);
98 assertThat(percentType, is(PercentType.valueOf("52")));
100 percentType = jdbcBaseDAO.objectAsState(new RollershutterItem("testRollershutterItem"), null, 39);
101 assertInstanceOf(PercentType.class, percentType);
102 assertThat(percentType, is(PercentType.valueOf("39")));
104 State openClosedType = jdbcBaseDAO.objectAsState(new ContactItem("testContactItem"), null, "OPEN");
105 assertInstanceOf(OpenClosedType.class, openClosedType);
106 assertThat(openClosedType, is(OpenClosedType.OPEN));
108 State playPauseType = jdbcBaseDAO.objectAsState(new PlayerItem("testPlayerItem"), null, "PLAY");
109 assertInstanceOf(PlayPauseType.class, playPauseType);
110 assertThat(playPauseType, is(PlayPauseType.PLAY));
111 State rewindFastforwardType = jdbcBaseDAO.objectAsState(new PlayerItem("testPlayerItem"), null, "REWIND");
112 assertInstanceOf(RewindFastforwardType.class, rewindFastforwardType);
113 assertThat(rewindFastforwardType, is(RewindFastforwardType.REWIND));
115 State onOffType = jdbcBaseDAO.objectAsState(new SwitchItem("testSwitchItem"), null, "ON");
116 assertInstanceOf(OnOffType.class, onOffType);
117 assertThat(onOffType, is(OnOffType.ON));
119 State stringListType = jdbcBaseDAO.objectAsState(new CallItem("testCallItem"), null, "0699222222,0179999998");
120 assertInstanceOf(StringListType.class, stringListType);
121 assertThat(stringListType, is(StringListType.valueOf("0699222222,0179999998")));
123 State expectedRawType = new RawType(new byte[0], "application/octet-stream");
124 State rawType = jdbcBaseDAO.objectAsState(new ImageItem("testImageItem"), null, expectedRawType.toFullString());
125 assertInstanceOf(RawType.class, rawType);
126 assertThat(rawType, is(expectedRawType));
128 State pointType = jdbcBaseDAO.objectAsState(new LocationItem("testLocationItem"), null, "1,2,3");
129 assertInstanceOf(PointType.class, pointType);
130 assertThat(pointType, is(PointType.valueOf("1,2,3")));
132 State stringType = jdbcBaseDAO.objectAsState(new StringItem("testStringItem"), null, "String");
133 assertInstanceOf(StringType.class, stringType);
134 assertThat(stringType, is(StringType.valueOf("String")));
138 public void testHistItemFilterQueryProviderReturnsSelectQueryWithoutWhereClauseDescendingOrder() {
139 String sql = jdbcBaseDAO.histItemFilterQueryProvider(filter, 0, DB_TABLE_NAME, "TEST", UTC_ZONE_ID);
140 assertThat(sql, is("SELECT time, value FROM " + DB_TABLE_NAME + " ORDER BY time DESC"));
144 public void testHistItemFilterQueryProviderReturnsSelectQueryWithoutWhereClauseAscendingOrder() {
145 filter.setOrdering(Ordering.ASCENDING);
147 String sql = jdbcBaseDAO.histItemFilterQueryProvider(filter, 0, DB_TABLE_NAME, "TEST", UTC_ZONE_ID);
148 assertThat(sql, is("SELECT time, value FROM " + DB_TABLE_NAME + " ORDER BY time ASC"));
152 public void testHistItemFilterQueryProviderWithStartAndEndDateReturnsDeleteQueryWithWhereClauseDescendingOrder() {
153 filter.setBeginDate(parseDateTimeString("2022-01-10T15:01:44"));
154 filter.setEndDate(parseDateTimeString("2022-01-15T15:01:44"));
156 String sql = jdbcBaseDAO.histItemFilterQueryProvider(filter, 0, DB_TABLE_NAME, "TEST", UTC_ZONE_ID);
157 assertThat(sql, is("SELECT time, value FROM " + DB_TABLE_NAME + " WHERE TIME>'" //
158 + JdbcBaseDAO.JDBC_DATE_FORMAT.format(filter.getBeginDate()) + "'" //
159 + " AND TIME<'" + JdbcBaseDAO.JDBC_DATE_FORMAT.format(filter.getEndDate()) + "' ORDER BY time DESC"));
163 public void testHistItemFilterQueryProviderReturnsSelectQueryWithoutWhereClauseDescendingOrderAndLimit() {
164 filter.setPageSize(1);
166 String sql = jdbcBaseDAO.histItemFilterQueryProvider(filter, 0, DB_TABLE_NAME, "TEST", UTC_ZONE_ID);
167 assertThat(sql, is("SELECT time, value FROM " + DB_TABLE_NAME + " ORDER BY time DESC LIMIT 0,1"));
171 public void testHistItemFilterDeleteProviderReturnsDeleteQueryWithoutWhereClause() {
172 String sql = jdbcBaseDAO.histItemFilterDeleteProvider(filter, DB_TABLE_NAME, UTC_ZONE_ID);
173 assertThat(sql, is("TRUNCATE TABLE " + DB_TABLE_NAME));
177 public void testHistItemFilterDeleteProviderWithStartAndEndDateReturnsDeleteQueryWithWhereClause() {
178 filter.setBeginDate(parseDateTimeString("2022-01-10T15:01:44"));
179 filter.setEndDate(parseDateTimeString("2022-01-15T15:01:44"));
181 String sql = jdbcBaseDAO.histItemFilterDeleteProvider(filter, DB_TABLE_NAME, UTC_ZONE_ID);
182 assertThat(sql, is("DELETE FROM " + DB_TABLE_NAME + " WHERE TIME>'" //
183 + JdbcBaseDAO.JDBC_DATE_FORMAT.format(filter.getBeginDate()) + "'" //
184 + " AND TIME<'" + JdbcBaseDAO.JDBC_DATE_FORMAT.format(filter.getEndDate()) + "'"));
188 public void testResolveTimeFilterWithNoDatesReturnsEmptyString() {
189 String sql = jdbcBaseDAO.resolveTimeFilter(filter, UTC_ZONE_ID);
190 assertThat(sql, is(""));
194 public void testResolveTimeFilterWithStartDateOnlyReturnsWhereClause() {
195 filter.setBeginDate(parseDateTimeString("2022-01-10T15:01:44"));
197 String sql = jdbcBaseDAO.resolveTimeFilter(filter, UTC_ZONE_ID);
198 assertThat(sql, is(" WHERE TIME>'" + JdbcBaseDAO.JDBC_DATE_FORMAT.format(filter.getBeginDate()) + "'"));
202 public void testResolveTimeFilterWithEndDateOnlyReturnsWhereClause() {
203 filter.setEndDate(parseDateTimeString("2022-01-15T15:01:44"));
205 String sql = jdbcBaseDAO.resolveTimeFilter(filter, UTC_ZONE_ID);
206 assertThat(sql, is(" WHERE TIME<'" + JdbcBaseDAO.JDBC_DATE_FORMAT.format(filter.getEndDate()) + "'"));
210 public void testResolveTimeFilterWithStartAndEndDateReturnsWhereClauseWithTwoConditions() {
211 filter.setBeginDate(parseDateTimeString("2022-01-10T15:01:44"));
212 filter.setEndDate(parseDateTimeString("2022-01-15T15:01:44"));
214 String sql = jdbcBaseDAO.resolveTimeFilter(filter, UTC_ZONE_ID);
215 assertThat(sql, is(" WHERE TIME>'" + JdbcBaseDAO.JDBC_DATE_FORMAT.format(filter.getBeginDate()) + "'" //
216 + " AND TIME<'" + JdbcBaseDAO.JDBC_DATE_FORMAT.format(filter.getEndDate()) + "'"));
219 private ZonedDateTime parseDateTimeString(String dts) {
220 return ZonedDateTime.of(LocalDateTime.parse(dts, DATE_PARSER), UTC_ZONE_ID);