Update Javadoc for libcobj/call (#789)

* doc:  update Javadoc for libcobj/call

* doc: update Javadoc for CobolResolve.isActive()

* doc: apply Claude review

Author: tsh-hashimoto

libcobj/app/src/main/java/jp/osscons/opensourcecobol/libcobj/call/CobolResolve.java

@@ -317,7 +317,8 @@ private static void setPackagePath(String path) {
      * @param runner CobolRunnableを実装したクラス。nullでもよい。
      * @return runnerがnullでない場合はrunnerを返し、そうでないときはクラス名とパッケージ名を元に検索処理を実施する。
      *     検索して動的にクラスの読み込みに成功したら、それを返す。検索に失敗したら nullを返す。
-     * @throws CobolRuntimeException TODO: 準備中
+     * @throws CobolRuntimeException runnerがnullの場合に、委譲先の {@link #resolve(String, String)}
+     *     で指定されたプログラム名に対応するクラスが見つからない場合にスローされる
      */
     public static CobolRunnable resolve(
             String packageName, AbstractCobolField cobolField, CobolRunnable runner)
@@ -341,7 +342,8 @@ public static CobolRunnable resolve(
      * @param runner CobolRunnableを実装したクラス。nullでもよい。
      * @return runnerがnullでない場合はrunnerを返し、そうでないときはクラス名とパッケージ名を元に検索処理を実施する。
      *     検索して動的にクラスの読み込みに成功したら、それを返す。検索に失敗したら nullを返す。
-     * @throws CobolRuntimeException TODO: 準備中
+     * @throws CobolRuntimeException runnerがnullの場合に、委譲先の {@link #resolve(String, String)}
+     *     で指定されたプログラム名に対応するクラスが見つからない場合にスローされる
      */
     public static CobolRunnable resolve(String packageName, String name, CobolRunnable runner)
             throws CobolRuntimeException {
@@ -362,7 +364,7 @@ public static CobolRunnable resolve(String packageName, String name, CobolRunnab
      * @param packageName パッケージ名
      * @param cobolField 読み込むクラスの名前
      * @return クラス名とパッケージ名を元に検索処理を実施する。 検索して動的にクラスの読み込みに成功したら、それを返す。検索に失敗したら nullを返す。
-     * @throws CobolRuntimeException TODO: 準備中
+     * @throws CobolRuntimeException 指定されたプログラム名に対応するクラスが見つからない場合にスローされる
      */
     public static CobolRunnable resolve(String packageName, AbstractCobolField cobolField)
             throws CobolRuntimeException {
@@ -379,7 +381,7 @@ public static CobolRunnable resolve(String packageName, AbstractCobolField cobol
      * @param packageName パッケージ名
      * @param name 読み込むクラスの名前
      * @return クラス名とパッケージ名を元に検索処理を実施する。 検索して動的にクラスの読み込みに成功したら、それを返す。検索に失敗したら nullを返す。
-     * @throws CobolRuntimeException TODO: 準備中
+     * @throws CobolRuntimeException 指定されたプログラム名に対応するクラスが見つからない場合にスローされる
      */
     public static CobolRunnable resolve(String packageName, String name)
             throws CobolRuntimeException {
@@ -464,6 +466,7 @@ private static CobolRunnable getInstance(String name) {
      * 引数で与えられたプログラム名に対応するCobolRunnableのインスタンスの cancelメソッドを呼び出す
      *
      * @param cobolField プログラム名を示すCOBOL変数
+     * @throws CobolRuntimeException 委譲先の {@link #cancel(String)} でプログラム名がnullの場合にスローされる
      */
     public static void cancel(AbstractCobolField cobolField) {
         cancel(cobolField.getString());
@@ -473,6 +476,7 @@ public static void cancel(AbstractCobolField cobolField) {
      * 引数で与えられたプログラム名に対応するCobolRunnableのインスタンスの cancelメソッドを呼び出す
      *
      * @param name プログラム名
+     * @throws CobolRuntimeException プログラム名がnullの場合にスローされる
      */
     public static void cancel(String name) {
         if (name == null) {
@@ -491,7 +495,7 @@ public static void cancel(String name) {
      * 指定のプログラムのcancelメソッドを呼び出す
      *
      * @param f cancelを呼び出すプログラム名を示すCOBOL変数
-     * @throws CobolStopRunException TODO: 準備中
+     * @throws CobolStopRunException プログラム名がnullまたは空文字列の場合にスローされる
      */
     public static void fieldCancel(AbstractCobolField f) throws CobolStopRunException {
         CobolResolve.cobCancel(f.fieldToString());
@@ -501,7 +505,7 @@ public static void fieldCancel(AbstractCobolField f) throws CobolStopRunExceptio
      * 指定のプログラムのcancelメソッドを呼び出す
      *
      * @param name プログラム名
-     * @throws CobolStopRunException TODO: 準備中
+     * @throws CobolStopRunException プログラム名がnullまたは空文字列の場合にスローされる
      */
     public static void cobCancel(String name) throws CobolStopRunException {
         if (name == null || name.equals("")) {

libcobj/app/src/main/java/jp/osscons/opensourcecobol/libcobj/call/CobolRunnable.java

@@ -34,9 +34,10 @@ public interface CobolRunnable {
     void cancel();
 
     /**
-     * 取り扱いについては準備中
+     * プログラムがCANCEL可能でない状態かどうかを返す。 {@link CobolResolve#cancel(String)}
+     * から呼び出され、falseの場合にCANCEL処理が実行される。
      *
-     * @return 準備中
+     * @return プログラムが実行中などでCANCELできない場合はtrue、CANCEL可能な場合はfalse
      */
     boolean isActive();
 }