svn commit: r1718632 - in /jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api: IllegalRepositoryStateException.java package-info.java

[fr...@apache.org]

Author: frm
Date: Tue Dec  8 15:14:57 2015
New Revision: 1718632

URL: http://svn.apache.org/viewvc?rev=1718632&view=rev
Log:
OAK-3745 - Add IllegalRepositoryStateException to the Content Repository API

Added:
    jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/IllegalRepositoryStateException.java
Modified:
    jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/package-info.java

Added: jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/IllegalRepositoryStateException.java
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/IllegalRepositoryStateException.java?rev=1718632&view=auto
==============================================================================
--- jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/IllegalRepositoryStateException.java (added)
+++ jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/IllegalRepositoryStateException.java Tue Dec  8 15:14:57 2015
@@ -0,0 +1,47 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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 org.apache.jackrabbit.oak.api;
+
+/**
+ * This exception can be thrown by implementers of this API to signal an error
+ * condition caused by an invalid state of the repository.
+ * <p>
+ * It's up to the implementation to distinguish between recoverable and
+ * unrecoverable error conditions. In case of recoverable error conditions, it's
+ * appropriate for an implementation to create a subclass of this exception and
+ * expose that subclass as part of its public API. This way, clients of the
+ * Content Repository API can catch specific failures, provided that they also
+ * want to introduce a dependency to the implementation's API.
+ */
+public class IllegalRepositoryStateException extends RuntimeException {
+
+    public IllegalRepositoryStateException() {
+    }
+
+    public IllegalRepositoryStateException(String message) {
+        super(message);
+    }
+
+    public IllegalRepositoryStateException(String message, Throwable cause) {
+        super(message, cause);
+    }
+
+    public IllegalRepositoryStateException(Throwable cause) {
+        super(cause);
+    }
+
+}

Modified: jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/package-info.java
URL: http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/package-info.java?rev=1718632&r1=1718631&r2=1718632&view=diff
==============================================================================
--- jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/package-info.java (original)
+++ jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/package-info.java Tue Dec  8 15:14:57 2015
@@ -18,7 +18,7 @@
 /**
  * Oak repository API
  */
-@Version("3.0.0")
+@Version("3.1.0")
 @Export(optional = "provide:=true")
 package org.apache.jackrabbit.oak.api;