Kod Status dan Pengendalian Ralat
Pelajari cara menggunakan kod status gRPC dengan berkesan serta melaksanakan penyebaran dan pengendalian ralat yang betul dalam perkhidmatan anda.
Kod Status dan Pengendalian Ralat ialah pelajaran gRPC & API Berprestasi Tinggi percuma di CoddyKit. Ini ialah pelajaran 1 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran gRPC & API Berprestasi Tinggi, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus gRPC & API Berprestasi Tinggi merangkumi sejumlah 4 pelajaran.
Mengapa Mengendalikan Ralat gRPC?
Dalam mana-mana aplikasi yang teguh, ralat tidak dapat dielakkan. Cara kita mengendalikannya boleh menentukan sama ada kebolehpercayaan sistem dan pengalaman pengguna menjadi baik atau sebaliknya.
Bagi sistem teragih yang menggunakan gRPC, pengendalian ralat yang konsisten amat penting. Pengendalian ini memastikan perkhidmatan dapat menyampaikan masalah dengan jelas dan klien dapat bertindak dengan sewajarnya.
Kenali Kod Status gRPC
gRPC menggunakan set Kod Status piawai untuk menunjukkan hasil sesuatu RPC (Panggilan Prosedur Jauh). Kod ini menyediakan cara sejagat untuk memahami sebab sesuatu panggilan berjaya atau gagal.
Anggap kod ini seperti kod status HTTP, tetapi khusus untuk gRPC. Antara kod yang biasa termasuk:
OK: RPC selesai dengan jayanya.NOT_FOUND: Sumber tidak ditemui (contohnya, ID pengguna tidak wujud).INTERNAL: Ralat yang tidak dijangka berlaku pada pelayan.UNAUTHENTICATED: Permintaan tidak mempunyai kelayakan pengesahan yang sah.
Takrif Perkhidmatan Protobuf
Sebelum melihat pengendalian ralat, mari kita takrifkan perkhidmatan mudah dalam fail .proto. Fail ini mentakrifkan struktur mesej dan kaedah RPC kita.
Kita akan mencipta UserService dengan kaedah GetUser yang menerima UserRequest dan mengembalikan User.
syntax = "proto3";
option java_multiple_files = true;
option java_package = "com.coddykit.grpc.error";
option java_outer_classname = "ErrorProto";
package errorhandling;
message UserRequest {
int32 id = 1;
}
message User {
int32 id = 1;
string name = 2;
string email = 3;
}
service UserService {
rpc GetUser (UserRequest) returns (User);
}Isyarat Ralat dari Sisi Pelayan
Pada pelayan, apabila sesuatu operasi gagal, anda tidak membuang pengecualian biasa. Sebaliknya, anda mencipta objek gRPC Status dengan kod dan perihalan yang sesuai, kemudian menukarkannya kepada StatusRuntimeException.
Pengecualian ini kemudiannya dihantar kembali kepada klien melalui kaedah responseObserver.onError(), bagi memastikan klien menerima ralat gRPC yang piawai.
Pelaksanaan Ralat Pelayan
Cuba jalankan contoh ini. Server akan memberikan ralat NOT_FOUND jika anda meminta sebarang ID pengguna selain 1.
import io.grpc.Server;
import io.grpc.ServerBuilder;
import io.grpc.Status;
import io.grpc.stub.StreamObserver;
import com.coddykit.grpc.error.ErrorProto.User;
import com.coddykit.grpc.error.ErrorProto.UserRequest;
import com.coddykit.grpc.error.UserServiceGrpc;
public class ErrorServer {
private static final int PORT = 50051;
public static void main(String[] args) throws Exception {
Server server = ServerBuilder.forPort(PORT)
.addService(new UserServiceImpl())
.build();
server.start();
System.out.println("Server started on port " + PORT);
server.awaitTermination();
}
static class UserServiceImpl extends UserServiceGrpc.UserServiceImplBase {
@Override
public void getUser(UserRequest request, StreamObserver<User> responseObserver) {
System.out.println("Received GetUser request for ID: " + request.getId());
if (request.getId() == 1) {
User user = User.newBuilder()
.setId(1)
.setName("Alice")
.setEmail("alice@example.com")
.build();
responseObserver.onNext(user);
responseObserver.onCompleted();
} else {
Status status = Status.NOT_FOUND.withDescription("User with ID " + request.getId() + " not found.");
responseObserver.onError(status.asRuntimeException());
}
}
}
}Pengendalian Ralat pada Klien
Pada bahagian klien, ralat gRPC biasanya diterima sebagai StatusRuntimeException. Anda hendaklah membungkus panggilan gRPC anda dalam blok try-catch untuk mengendalikan pengecualian ini dengan baik.
Dalam blok catch, anda boleh memeriksa objek Status daripada pengecualian untuk menentukan kod dan penerangan ralat, supaya klien anda dapat memberikan respons yang sesuai.
Demo Pengendalian Ralat Klien
Jalankan kod klien ini selepas memulakan server daripada adegan sebelumnya. Perhatikan cara kod ini mengendalikan carian pengguna yang berjaya dan ralat 'tidak ditemui'.
import io.grpc.ManagedChannel;
import io.grpc.ManagedChannelBuilder;
import io.grpc.StatusRuntimeException;
import com.coddykit.grpc.error.ErrorProto.User;
import com.coddykit.grpc.error.ErrorProto.UserRequest;
import com.coddykit.grpc.error.UserServiceGrpc;
public class ErrorClient {
private static final int PORT = 50051;
private static final String HOST = "localhost";
public static void main(String[] args) {
ManagedChannel channel = ManagedChannelBuilder.forAddress(HOST, PORT)
.usePlaintext() // For local testing without TLS
.build();
UserServiceGrpc.UserServiceBlockingStub blockingStub = UserServiceGrpc.newBlockingStub(channel);
// Scenario 1: User found
try {
UserRequest foundRequest = UserRequest.newBuilder().setId(1).build();
User user = blockingStub.getUser(foundRequest);
System.out.println("User found: " + user.getName());
} catch (StatusRuntimeException e) {
System.err.println("Error calling GetUser (found scenario): " + e.getStatus().getCode() + " - " + e.getStatus().getDescription());
}
System.out.println("\n--- Trying to get a non-existent user ---");
// Scenario 2: User not found (expected error)
try {
UserRequest notFoundRequest = UserRequest.newBuilder().setId(99).build();
User user = blockingStub.getUser(notFoundRequest);
System.out.println("User found (unexpected): " + user.getName()); // This line should not be reached
} catch (StatusRuntimeException e) {
System.err.println("Error calling GetUser (not found scenario):");
System.err.println(" Status Code: " + e.getStatus().getCode());
System.err.println(" Description: " + e.getStatus().getDescription());
} finally {
channel.shutdown();
}
}
}Penyebaran Ralat yang Berkesan
Penyebaran ralat yang betul amat penting. Apabila perkhidmatan gRPC memanggil perkhidmatan dalaman yang lain dan menemui ralat, langkah yang biasanya terbaik ialah:
- Logkan ralat dengan perincian yang mencukupi untuk penyahpepijatan.
- Terjemahkan ralat kepada kod gRPC
Statusyang sesuai untuk klien pemanggil. Jangan dedahkan ralat sistem dalaman secara langsung. - Jangan menyembunyikan ralat. Sentiasa kendalikannya atau lemparkannya semula supaya ralat tersebut tidak hilang secara senyap.
Uji Pengetahuan Anda
Anda sedang membina perkhidmatan gRPC yang menjalankan pengiraan kompleks. Jika data input tidak sah (contohnya, nombor negatif sedangkan hanya nombor positif dibenarkan), kod gRPC Status manakah yang paling sesuai untuk dikembalikan?
Kesimpulan Utama
Anda telah mempelajari asas pengendalian ralat gRPC!
- gRPC menggunakan Kod Status piawai untuk menyampaikan hasil RPC.
- Server menandakan ralat dengan mencipta objek
Statusdan memanggilresponseObserver.onError(). - Klien mengendalikan ralat dengan menangkap
StatusRuntimeExceptiondan memeriksa objekStatusnya. - Sentiasa sebarkan ralat dengan jelas dan terjemahkannya dengan sewajarnya untuk klien.
Pendekatan berstruktur ini memastikan komunikasi yang boleh dipercayai dalam sistem teragih anda.
Pelajari gRPC & API Berprestasi Tinggi dengan tutor kecerdasan buatan — percuma
Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.
- Kursus
- 12
- Pelajaran
- 48
Soalan Lazim
Adakah pelajaran “Kod Status dan Pengendalian Ralat” percuma?
Ya — teks penuh “Kod Status dan Pengendalian Ralat” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus gRPC & API Berprestasi Tinggi, tingkat taraf kepada CoddyKit PRO. Kursus gRPC & API Berprestasi Tinggi merangkumi sejumlah 4 pelajaran.
Apakah yang akan saya pelajari dalam “Kod Status dan Pengendalian Ralat”?
Pelajari cara menggunakan kod status gRPC dengan berkesan serta melaksanakan penyebaran dan pengendalian ralat yang betul dalam perkhidmatan anda. Anda berlatih gRPC & API Berprestasi Tinggi menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.
Adakah saya memerlukan pengalaman untuk memulakan gRPC & API Berprestasi Tinggi?
Tiada pengalaman terdahulu diperlukan. Pembelajaran gRPC & API Berprestasi Tinggi di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 1 daripada 4.
Berapa lamakah pelajaran “Kod Status dan Pengendalian Ralat” diambil?
Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.
Bolehkah saya menulis dan menjalankan kod dalam pelajaran gRPC & API Berprestasi Tinggi ini?
Ya. Setiap pelajaran gRPC & API Berprestasi Tinggi menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.
Semua pelajaran dalam kursus ini
- Kod Status dan Pengendalian Ralat
- Penghantaran Metadata Tersuai
- Konteks dan Tarikh Akhir
- Model Ralat Kaya dengan google.rpc.Status