1 files changed, 58 insertions, 0 deletions
diff --git a/src/java/com/android/ike/ikev2/IkeSessionCallback.java b/src/java/com/android/ike/ikev2/IkeSessionCallback.java
new file mode 100644
index 00000000..66081206
--- /dev/null
+++ b/src/java/com/android/ike/ikev2/IkeSessionCallback.java
@@ -0,0 +1,58 @@
+/*
+ * Copyright (C) 2019 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.android.ike.ikev2;
+
+import android.annotation.NonNull;
+
+import com.android.ike.ikev2.exceptions.IkeException;
+
+/** Callback interface for receiving state changes of an IKE Session. */
+public interface IkeSessionCallback {
+    /**
+     * Called when negotiation and authentication for this new IKE Session succeeds.
+     *
+     * @param sessionConfiguration the configuration information of IKE Session negotiated during
+     *     IKE setup.
+     */
+    void onOpened(@NonNull IkeSessionConfiguration sessionConfiguration);
+
+    /**
+     * Called when either side has decided to close this Session and the deletion exchange
+     * finishes.
+     *
+     * <p>This method will not be fired if this deletion is caused by a fatal error.
+     */
+    void onClosed();
+
+    /**
+     * Called if IKE Session negotiation fails or IKE Session is closed because of a fatal error.
+     *
+     * @param exception the detailed error.
+     */
+    void onClosedExceptionally(IkeException exception);
+
+    /**
+     * Called if a recoverable error is encountered in an established IKE Session.
+     *
+     * <p>A potential risk is usually detected when IKE library receives a non-protected error
+     * notification (e.g. INVALID_IKE_SPI) or a non-fatal error notification (e.g.
+     * INVALID_MESSAGE_ID).
+     *
+     * @param exception the detailed error.
+     */
+    void onError(IkeException exception);
+}