goldenChat base source add

ta4j-master/ta4j-examples/src/main/java/ta4jexamples/datasources/http/HttpBarSeriesDataSource.java

@@ -0,0 +1,46 @@
+/*
+ * SPDX-License-Identifier: MIT
+ */
+package ta4jexamples.datasources.http;
+
+import ta4jexamples.datasources.BarSeriesDataSource;
+
+/**
+ * Marker interface for HTTP-based BarSeries data sources.
+ * <p>
+ * This interface extends {@link BarSeriesDataSource} to identify data sources
+ * that fetch data over HTTP. Implementations of this interface typically use
+ * {@link HttpClientWrapper} for making HTTP requests and may support response
+ * caching.
+ * <p>
+ * HTTP-based data sources share common functionality such as:
+ * <ul>
+ * <li>HTTP request handling via {@link HttpClientWrapper}</li>
+ * <li>Response caching to disk for faster subsequent requests</li>
+ * <li>Cache validation and management</li>
+ * <li>Pagination for large data requests</li>
+ * </ul>
+ * <p>
+ * For shared implementation, consider extending
+ * {@link AbstractHttpBarSeriesDataSource} which provides common HTTP and
+ * caching infrastructure.
+ *
+ * @since 0.20
+ */
+public interface HttpBarSeriesDataSource extends BarSeriesDataSource {
+
+    /**
+     * Returns the HttpClientWrapper used by this data source for making HTTP
+     * requests.
+     *
+     * @return the HttpClientWrapper instance
+     */
+    HttpClientWrapper getHttpClient();
+
+    /**
+     * Returns whether response caching is enabled for this data source.
+     *
+     * @return true if caching is enabled, false otherwise
+     */
+    boolean isResponseCachingEnabled();
+}