View Javadoc
1   /*
2    *    Copyright 2009-2024 the original author or authors.
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    *       https://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 org.apache.ibatis.type;
17  
18  import static org.junit.jupiter.api.Assertions.assertEquals;
19  import static org.junit.jupiter.api.Assertions.assertNull;
20  import static org.junit.jupiter.api.Assertions.assertThrows;
21  import static org.mockito.ArgumentMatchers.any;
22  import static org.mockito.ArgumentMatchers.anyString;
23  import static org.mockito.Mockito.mock;
24  import static org.mockito.Mockito.verify;
25  import static org.mockito.Mockito.when;
26  
27  import java.sql.Array;
28  import java.sql.Connection;
29  import java.sql.Types;
30  
31  import org.junit.jupiter.api.Test;
32  import org.mockito.Mock;
33  
34  class ArrayTypeHandlerTest extends BaseTypeHandlerTest {
35  
36    private static final TypeHandler<Object> TYPE_HANDLER = new ArrayTypeHandler();
37  
38    @Mock
39    Array mockArray;
40  
41    @Override
42    @Test
43    public void shouldSetParameter() throws Exception {
44      TYPE_HANDLER.setParameter(ps, 1, mockArray, null);
45      verify(ps).setArray(1, mockArray);
46    }
47  
48    @Test
49    void shouldSetStringArrayParameter() throws Exception {
50      Connection connection = mock(Connection.class);
51      when(ps.getConnection()).thenReturn(connection);
52  
53      Array array = mock(Array.class);
54      when(connection.createArrayOf(anyString(), any(String[].class))).thenReturn(array);
55  
56      TYPE_HANDLER.setParameter(ps, 1, new String[] { "Hello World" }, JdbcType.ARRAY);
57      verify(ps).setArray(1, array);
58      verify(array).free();
59    }
60  
61    @Test
62    void shouldSetNullParameter() throws Exception {
63      TYPE_HANDLER.setParameter(ps, 1, null, JdbcType.ARRAY);
64      verify(ps).setNull(1, Types.ARRAY);
65    }
66  
67    @Test
68    void shouldFailForNonArrayParameter() {
69      assertThrows(TypeException.class, () -> TYPE_HANDLER.setParameter(ps, 1, "unsupported parameter type", null));
70    }
71  
72    @Override
73    @Test
74    public void shouldGetResultFromResultSetByName() throws Exception {
75      when(rs.getArray("column")).thenReturn(mockArray);
76      String[] stringArray = { "a", "b" };
77      when(mockArray.getArray()).thenReturn(stringArray);
78      assertEquals(stringArray, TYPE_HANDLER.getResult(rs, "column"));
79      verify(mockArray).free();
80    }
81  
82    @Override
83    @Test
84    public void shouldGetResultNullFromResultSetByName() throws Exception {
85      when(rs.getArray("column")).thenReturn(null);
86      assertNull(TYPE_HANDLER.getResult(rs, "column"));
87    }
88  
89    @Override
90    @Test
91    public void shouldGetResultFromResultSetByPosition() throws Exception {
92      when(rs.getArray(1)).thenReturn(mockArray);
93      String[] stringArray = { "a", "b" };
94      when(mockArray.getArray()).thenReturn(stringArray);
95      assertEquals(stringArray, TYPE_HANDLER.getResult(rs, 1));
96      verify(mockArray).free();
97    }
98  
99    @Override
100   @Test
101   public void shouldGetResultNullFromResultSetByPosition() throws Exception {
102     when(rs.getArray(1)).thenReturn(null);
103     assertNull(TYPE_HANDLER.getResult(rs, 1));
104   }
105 
106   @Override
107   @Test
108   public void shouldGetResultFromCallableStatement() throws Exception {
109     when(cs.getArray(1)).thenReturn(mockArray);
110     String[] stringArray = { "a", "b" };
111     when(mockArray.getArray()).thenReturn(stringArray);
112     assertEquals(stringArray, TYPE_HANDLER.getResult(cs, 1));
113     verify(mockArray).free();
114   }
115 
116   @Override
117   @Test
118   public void shouldGetResultNullFromCallableStatement() throws Exception {
119     when(cs.getArray(1)).thenReturn(null);
120     assertNull(TYPE_HANDLER.getResult(cs, 1));
121   }
122 
123 }