Halaman ini diterjemahkan oleh Cloud Translation API.

Cara menangani error Java Callout

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X. info

Apa yang dimaksud dengan info Java?

Jika Anda baru menggunakan info Java, sebaiknya mulai dengan Cara membuat info Java info.

Menangani error di Keterangan Java

Ketika menulis Keterangan Java, Anda mungkin ingin melakukan penanganan error khusus dalam kode Java. Sebagai Anda mungkin ingin menampilkan pesan error khusus dan header dan/atau menetapkan variabel alur dengan informasi error dalam alur proxy di Edge.

Mari kita pelajari contoh Info Java sederhana yang menggambarkan penanganan error kustom dasar pola-pola tersebut. Contoh ini menampilkan pesan error kustom saat terjadi pengecualian. Ini juga menempatkan ke dalam variabel alur, yang bisa menjadi teknik proses debug yang berguna.

Tips: Lihat juga Cara melanjutkan error dalam info java. Perhatikan bahwa data yang tidak tertangani pengecualian di dalam resource Javacallout akan menyebabkan proxy memasukkan Status error, meskipun continueOnError ditetapkan ke true.

Mendownload project

Untuk mempermudah, Anda dapat mendownload project ini dari repositori api-platform-samples Apigee di GitHub.

Download atau clone api-platform-samples ke sistem Anda.
Di editor kode atau terminal pilihan Anda, buka Project api-platform-samples/doc-samples/java-error.

Contoh kode Java

Pola penanganan error sangat mudah. Anda dapat menetapkan variabel alur dalam Konteks alur edge dengan metode messageContext.setVariable(). Untuk menampilkan kustom informasi error, buat instance ExecutionResult dan panggil metode di dalamnya untuk mengatur respons kesalahan dan {i>header<i}.

package com.apigeesample;

import com.apigee.flow.execution.ExecutionContext;
import com.apigee.flow.execution.ExecutionResult;
import com.apigee.flow.execution.spi.Execution;
import com.apigee.flow.message.MessageContext;
import com.apigee.flow.execution.Action;

import org.apache.commons.lang.exception.ExceptionUtils;


public class JavaError implements Execution {
    public ExecutionResult execute(MessageContext messageContext, ExecutionContext executionContext) {

        try {

                String name = messageContext.getMessage().getHeader("username");

                if (name != null && name.length()>0) {
                        messageContext.getMessage().setContent("Hello, " + name + "!");
                        messageContext.getMessage().removeHeader("username");

                } else {
                        throw new RuntimeException("Please specify a name parameter!");
                }

                return ExecutionResult.SUCCESS;

        } catch (RuntimeException ex) {

            ExecutionResult executionResult = new ExecutionResult(false, Action.ABORT);

            //--Returns custom error message and header
            executionResult.setErrorResponse(ex.getMessage());
            executionResult.addErrorResponseHeader("ExceptionClass", ex.getClass().getName());

            //--Set flow variables -- may be useful for debugging.
            messageContext.setVariable("JAVA_ERROR", ex.getMessage());
            messageContext.setVariable("JAVA_STACKTRACE", ExceptionUtils.getStackTrace(ex));
            return executionResult;
        }
    }
}

Kompilasi kode Anda dengan Maven

Project disiapkan agar Anda dapat mengompilasi dengan Maven. Jika Anda ingin menggunakan javac, kami juga akan menyertakan contoh.

Pastikan Anda telah menginstal Maven:
```
mvn -version
```
Jalankan skrip java-error/buildsetup.sh. Skrip ini menginstal skrip Dependensi JAR di repo Maven lokal Anda.
ke direktori java-error/callout.
Jalankan Maven:
```
mvn clean package
```
Catatan: Jika mengalami error Maven, pastikan Anda berada di Direktori java-error/callout.
Jika Anda mau, verifikasi bahwa file JAR edge-custom-policy-java-error.jar telah disalin ke java-error/apiproxy/resources/java. Ini adalah lokasi yang diperlukan untuk File JAR yang ingin Anda deploy dengan proxy.

Mengompilasi dengan javac

Jika ingin menggunakan javac untuk mengompilasi kode, Anda dapat melakukan sesuatu yang mirip dengan mengikuti (dari direktori java-error). File JAR yang diperlukan disediakan untuk Anda di direktori java-error/lib.

cd ke api-platform-samples/doc-samples/java-error.
Pastikan Anda memiliki javac di jalur Anda.
```
javac -version
```

Jalankan perintah javac berikut:

javac -d . -classpath ./lib/expressions-1.0.0.jar:./lib/message-flow-1.0.0.jar:. callout/src/main/java/JavaProperties.java

Salin file JAR ke direktori apiproxy/resources/java. Ini adalah lokasi yang diperlukan untuk file JAR yang ingin Anda deploy dengan proxy.
```
cp com/apigeesample/JavaProperties.class apiproxy/resources/java
```

Men-deploy dan memanggil proxy

Skrip deploy disediakan di direktori ./java-error. Tapi sebelum Anda menjalankannya, Anda perlu melakukan pengaturan cepat.

cd ke api-platform-samples/doc-samples/java-error
Jika Anda belum melakukannya, buka file ../../setup/setenv.sh dan edit seperti yang ditunjukkan dengan informasi akun Apigee Anda: nama pengguna Anda (alamat email yang dikaitkan dengan akun Anda), nama organisasi, dan domain yang digunakan untuk membuat API manajemen proyek. Misalnya, untuk cloud Edge, domainnya adalah https://api.enterprise.apigee.com; Namun, domain Anda mungkin berbeda jika Anda menggunakan Edge Private Cloud.
Simpan file setenv.sh.
Jalankan skrip deploy:
```
./deploy.sh
```
Jika deployment berhasil, jalankan skrip pemanggilan:
```
./invoke.sh
```
Skrip pemanggilan memanggil perintah cURL yang terlihat seperti ini:
```
curl  http://$org-$env.$api_domain/java-error
```
Karena panggilan tidak menyertakan "nama" parameter kueri, kode Java akan menampilkan runtime {i>error<i}. Proxy menampilkan pesan dan header ini:

Pesan error: Please specify a name parameter!
Header: ExceptionClass: java.lang.RuntimeException