Merge pull request #1756 from SunJiFengPlus/develop

translation: sermant-agentcore module

Author: Sherlockhan

sermant-agentcore/sermant-agentcore-core/pom.xml

@@ -104,7 +104,7 @@
             <version>${byte.buddy.version}</version>
         </dependency>
 
-        <!--    测试阶段使用的依赖，不会产生类冲突    -->
+        <!-- Dependencies used in the test scope that will not cause class conflicts -->
         <dependency>
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>

sermant-agentcore/sermant-agentcore-core/src/main/java/io/sermant/core/plugin/agent/declarer/AbstractPluginDescription.java

@@ -23,7 +23,6 @@
 import java.security.ProtectionDomain;
 
 /**
- * 抽象的插件描述器，简化类的匹配方法，仅使用类的描述器匹配
  * AbstractPluginDescription, simplifies the matching method of the class, only using the class description matching
  *
  * @author HapThorin

sermant-agentcore/sermant-agentcore-core/src/main/java/io/sermant/core/plugin/agent/declarer/InterceptDeclarer.java

@@ -35,7 +35,7 @@
  */
 public abstract class InterceptDeclarer {
     /**
-     * 日志
+     * Logger
      */
     private static final Logger LOGGER = LoggerFactory.getLogger();
 

sermant-agentcore/sermant-agentcore-core/src/main/java/io/sermant/core/plugin/agent/matcher/MethodMatcher.java

@@ -53,8 +53,8 @@ public boolean matches(MethodDescription methodDescription) {
     /**
      * Match methods with exact name
      *
-     * @param methodName 方法名称
-     * @return 方法匹配器对象
+     * @param methodName method name
+     * @return method matcher
      */
     public static MethodMatcher nameEquals(String methodName) {
         return new MethodMatcher() {

sermant-agentcore/sermant-agentcore-core/src/main/java/io/sermant/core/plugin/common/PluginSchemaValidator.java

@@ -64,7 +64,7 @@ public static void setDefaultVersion(String pluginName) {
     /**
      * Remove plugin version cache
      *
-     * @param pluginName 插件名
+     * @param pluginName plugin name
      */
     public static void removePluginVersionCache(String pluginName) {
         PLUGIN_VERSION_MAP.remove(pluginName);

sermant-agentcore/sermant-agentcore-core/src/main/java/io/sermant/core/plugin/subscribe/AbstractGroupConfigSubscriber.java

@@ -142,7 +142,7 @@ public static String createLabelGroup(Map<String, String> labels) {
     /**
      * Build group subscribers
      *
-     * @return 订阅全集
+     * @return All of subscriptions
      */
     protected abstract Map<String, DynamicConfigListener> buildGroupSubscribers();
 

sermant-agentcore/sermant-agentcore-core/src/main/java/io/sermant/core/utils/KeyGenerateUtils.java

@@ -29,8 +29,8 @@ private KeyGenerateUtils() {
     /**
      * Use Class to generate keys that carry classloader information
      *
-     * @param cls 类
-     * @return 键
+     * @param cls class
+     * @return key
      */
     public static String generateClassKeyWithClassLoader(Class<?> cls) {
         return cls.getName() + "@" + System.identityHashCode(cls.getClassLoader());

sermant-agentcore/sermant-agentcore-core/src/main/java/io/sermant/core/utils/ReflectUtils.java

@@ -77,7 +77,7 @@ private ReflectUtils() {
      *
      * @param target Target method
      * @param methodName Method name
-     * @return 结果
+     * @return invoke result
      */
     public static Optional<Object> invokeMethodWithNoneParameter(Object target, String methodName) {
         return invokeMethod(target, methodName, null, null);

sermant-agentcore/sermant-agentcore-core/src/main/java/io/sermant/core/utils/ServicesMetaInfUtils.java

@@ -44,7 +44,8 @@
 import javax.tools.StandardLocation;
 
 /**
- * 添加@HttpRouteMapping注解的类，在编译时自动生成io.sermant.core.service.httpserver.api.HttpRouteHandler的SPI
+ * Classes annotated with @HttpRouteMapping will automatically generate SPI configuration for
+ * io.sermant.core.service.httpserver.api.HttpRouteHandler during compile
  *
  * @author zwmagic
  * @since 2024-02-03

sermant-agentcore/sermant-agentcore-core/src/main/java/io/sermant/core/utils/SpiLoadUtils.java

@@ -37,12 +37,12 @@ private SpiLoadUtils() {
     }
 
     /**
-     * 从指定类加载起载入所有的服务
+     * Loads all services from the specified class loader
      *
-     * @param serviceClass SPI接口类
-     * @param classLoader 类加载器，从指定的类加载加载服务
-     * @param <T> 服务的具体类型
-     * @return 服务列表
+     * @param serviceClass SPI interface class
+     * @param classLoader class loader that loads services from the specified class loader
+     * @param <T> specific type of the service
+     * @return service list
      */
     public static <T> List<T> loadAll(Class<T> serviceClass, ClassLoader classLoader) {
         ServiceLoader<T> services = ServiceLoader.load(serviceClass, classLoader);