1 /* 2 * Licensed to the Apache Software Foundation (ASF) under one or more 3 * contributor license agreements. See the NOTICE file distributed with 4 * this work for additional information regarding copyright ownership. 5 * The ASF licenses this file to You under the Apache License, Version 2.0 6 * (the "License"); you may not use this file except in compliance with 7 * the License. You may obtain a copy of the License at 8 * 9 * http://www.apache.org/licenses/LICENSE-2.0 10 * 11 * Unless required by applicable law or agreed to in writing, software 12 * distributed under the License is distributed on an "AS IS" BASIS, 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 */ 17 18 package org.apache.shardingsphere.data.pipeline.core.ingest.position; 19 20 import org.apache.shardingsphere.infra.database.core.spi.DatabaseTypedSPI; 21 import org.apache.shardingsphere.infra.spi.annotation.SingletonSPI; 22 23 import javax.sql.DataSource; 24 import java.sql.SQLException; 25 26 /** 27 * Dialect ingest position manager. 28 */ 29 @SingletonSPI 30 public interface DialectIngestPositionManager extends DatabaseTypedSPI { 31 32 /** 33 * Init position by data source. 34 * 35 * @param dataSource data source 36 * @param slotNameSuffix slot name suffix 37 * @return position 38 * @throws SQLException SQL exception 39 */ 40 IngestPosition init(DataSource dataSource, String slotNameSuffix) throws SQLException; 41 42 /** 43 * Init position by string data. 44 * 45 * @param data string data 46 * @return position 47 */ 48 IngestPosition init(String data); 49 50 /** 51 * Clean up by data source if necessary. 52 * 53 * @param dataSource data source 54 * @param slotNameSuffix slot name suffix 55 * @throws SQLException SQL exception 56 */ 57 default void destroy(final DataSource dataSource, final String slotNameSuffix) throws SQLException { 58 } 59 }