first commit

backend/src/main/java/com/agricultural/stock/service/StockService.java

@@ -0,0 +1,106 @@
+package com.agricultural.stock.service;
+
+import com.agricultural.stock.entity.StockData;
+import com.agricultural.stock.vo.StockAnalysisVO;
+import com.agricultural.stock.vo.StockTrendVO;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 股票数据服务接口
+ * 
+ * @author Agricultural Stock Platform Team
+ */
+public interface StockService {
+
+    /**
+     * 获取实时股票数据
+     * 
+     * @return 股票数据列表
+     */
+    List<StockData> getRealtimeStockData();
+
+    /**
+     * 根据股票代码获取历史数据
+     * 
+     * @param stockCode 股票代码
+     * @param startDate 开始日期
+     * @param endDate 结束日期
+     * @return 历史股票数据列表
+     */
+    List<StockData> getHistoryData(String stockCode, LocalDateTime startDate, LocalDateTime endDate);
+
+    /**
+     * 获取涨幅排行榜
+     * 
+     * @param limit 排行数量
+     * @return 涨幅排行榜
+     */
+    List<StockData> getGrowthRanking(Integer limit);
+
+    /**
+     * 获取市值排行榜
+     * 
+     * @param limit 排行数量
+     * @return 市值排行榜
+     */
+    List<StockData> getMarketCapRanking(Integer limit);
+
+    /**
+     * 获取成交量排行榜
+     * 
+     * @param limit 排行数量
+     * @return 成交量排行榜
+     */
+    List<StockData> getVolumeRanking(Integer limit);
+
+    /**
+     * 获取股票趋势分析
+     * 
+     * @param stockCode 股票代码
+     * @param days 分析天数
+     * @return 股票趋势分析结果
+     */
+    StockTrendVO getStockTrend(String stockCode, Integer days);
+
+    /**
+     * 获取市场综合分析
+     * 
+     * @return 市场分析结果
+     */
+    StockAnalysisVO getMarketAnalysis();
+
+    /**
+     * 获取股票预测数据
+     * 
+     * @param stockCode 股票代码
+     * @param days 预测天数
+     * @return 预测数据列表
+     */
+    List<StockData> getStockPrediction(String stockCode, Integer days);
+
+    /**
+     * 搜索股票
+     * 
+     * @param keyword 搜索关键词
+     * @return 搜索结果
+     */
+    List<StockData> searchStocks(String keyword);
+
+    /**
+     * 保存股票数据
+     * 
+     * @param stockData 股票数据
+     * @return 保存结果
+     */
+    StockData saveStockData(StockData stockData);
+
+    /**
+     * 批量保存股票数据
+     * 
+     * @param stockDataList 股票数据列表
+     * @return 保存数量
+     */
+    Integer batchSaveStockData(List<StockData> stockDataList);
+}