see 03/03 log

Author: Blankj

utilcode/src/main/java/com/blankj/utilcode/util/ServiceUtils.java

@@ -16,7 +16,7 @@
  *     author: Blankj
  *     blog  : http://blankj.com
  *     time  : 2016/08/02
- *     desc  : 服务相关工具类
+ *     desc  : utils about service
  * </pre>
  */
 public final class ServiceUtils {
@@ -26,11 +26,11 @@ private ServiceUtils() {
     }
 
     /**
-     * 获取所有运行的服务
+     * Return all of the services are running.
      *
-     * @return 服务名集合
+     * @return all of the services are running
      */
-    public static Set getAllRunningService() {
+    public static Set getAllRunningServices() {
         ActivityManager am =
                 (ActivityManager) Utils.getApp().getSystemService(Context.ACTIVITY_SERVICE);
         if (am == null) return Collections.emptySet();
@@ -44,9 +44,9 @@ public static Set getAllRunningService() {
     }
 
     /**
-     * 启动服务
+     * Start the service.
      *
-     * @param className 完整包名的服务类名
+     * @param className The name of class.
      */
     public static void startService(final String className) {
         try {
@@ -57,20 +57,20 @@ public static void startService(final String className) {
     }
 
     /**
-     * 启动服务
+     * Start the service.
      *
-     * @param cls 服务类
+     * @param cls The service class.
      */
     public static void startService(final Class<?> cls) {
         Intent intent = new Intent(Utils.getApp(), cls);
         Utils.getApp().startService(intent);
     }
 
     /**
-     * 停止服务
+     * Stop the service.
      *
-     * @param className 完整包名的服务类名
-     * @return {@code true}: 停止成功<br>{@code false}: 停止失败
+     * @param className The name of class.
+     * @return {@code true}: success<br>{@code false}: fail
      */
     public static boolean stopService(final String className) {
         try {
@@ -82,23 +82,24 @@ public static boolean stopService(final String className) {
     }
 
     /**
-     * 停止服务
+     * Stop the service.
      *
-     * @param cls 服务类
-     * @return {@code true}: 停止成功<br>{@code false}: 停止失败
+     * @param cls The name of class.
+     * @return {@code true}: success<br>{@code false}: fail
      */
     public static boolean stopService(final Class<?> cls) {
         Intent intent = new Intent(Utils.getApp(), cls);
         return Utils.getApp().stopService(intent);
     }
 
     /**
-     * 绑定服务
+     * Bind the service.
      *
-     * @param className 完整包名的服务类名
-     * @param conn      服务连接对象
-     * @param flags     绑定选项
+     * @param className The name of class.
+     * @param conn      The ServiceConnection object.
+     * @param flags     Operation options for the binding.
      *                  <ul>
+     *                  <li>0</li>
      *                  <li>{@link Context#BIND_AUTO_CREATE}</li>
      *                  <li>{@link Context#BIND_DEBUG_UNBIND}</li>
      *                  <li>{@link Context#BIND_NOT_FOREGROUND}</li>
@@ -118,12 +119,13 @@ public static void bindService(final String className,
     }
 
     /**
-     * 绑定服务
+     * Bind the service.
      *
-     * @param cls   服务类
-     * @param conn  服务连接对象
-     * @param flags 绑定选项
+     * @param cls   The service class.
+     * @param conn  The ServiceConnection object.
+     * @param flags Operation options for the binding.
      *              <ul>
+     *              <li>0</li>
      *              <li>{@link Context#BIND_AUTO_CREATE}</li>
      *              <li>{@link Context#BIND_DEBUG_UNBIND}</li>
      *              <li>{@link Context#BIND_NOT_FOREGROUND}</li>
@@ -140,19 +142,19 @@ public static void bindService(final Class<?> cls,
     }
 
     /**
-     * 解绑服务
+     * Unbind the service.
      *
-     * @param conn 服务连接对象
+     * @param conn The ServiceConnection object.
      */
     public static void unbindService(final ServiceConnection conn) {
         Utils.getApp().unbindService(conn);
     }
 
     /**
-     * 判断服务是否运行
+     * Return whether service is running.
      *
-     * @param className 完整包名的服务类名
-     * @return {@code true}: 是<br>{@code false}: 否
+     * @param className The name of class.
+     * @return {@code true}: yes<br>{@code false}: no
      */
     public static boolean isServiceRunning(final String className) {
         ActivityManager am =