Added methods to parse to Optional using exceptions. Upgraded to JUnit 5

README.md

@@ -9,3 +9,5 @@ Currently there are five sets of methods:
 * `TryParse.tryParseLong`: a copy of `Long.parseLong` to parse to [OptionalLong](https://docs.oracle.com/javase/8/docs/api/java/util/OptionalLong.html) instead of throwing exceptions.
 * `TryParse.tryParseUnsignedLong`: a copy of `Long.parseUnsignedLong` to parse to [OptionalLong](https://docs.oracle.com/javase/8/docs/api/java/util/OptionalLong.html) instead of throwing exceptions.
 * `TryParse.tryParseBoolean`: a copy of `Boolean.parseBoolean` to parse to [Optional](https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html) instead of returning `false`.
+
+In addition, there are several methods that delegate to an existing method, catching expected exceptions. These are not as fast as the above five sets, but can still be useful.

pom.xml

@@ -72,7 +72,7 @@
     <version.java>1.8</version.java>
 
     <version.hamcrest>2.1</version.hamcrest>
-    <version.junit>4.12</version.junit>
+    <version.junit>5.4.2</version.junit>
     <version.mockito>2.28.2</version.mockito>
 
     <version.plugin.antrun>1.8</version.plugin.antrun>
@@ -96,8 +96,8 @@
 
   <dependencies>
     <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter</artifactId>
       <version>${version.junit}</version>
       <scope>test</scope>
     </dependency>

src/main/java/com/github/robtimus/tryparse/ExceptionBasedParsing.java

@@ -0,0 +1,37 @@
+/*
+ * ExceptionBasedParsing.java
+ * Copyright 2019 Rob Spoor
+ *
+ * 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.github.robtimus.tryparse;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Indicates that a method delegates to an existing method and catches its exceptions.
+ *
+ * @author Rob Spoor
+ * @since 1.1
+ */
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.SOURCE)
+@Documented
+public @interface ExceptionBasedParsing {
+    // marker annotation
+}

src/main/java/com/github/robtimus/tryparse/NativeParsing.java

@@ -0,0 +1,37 @@
+/*
+ * NativeParsing.java
+ * Copyright 2019 Rob Spoor
+ *
+ * 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.github.robtimus.tryparse;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Indicates that a method uses native parsing instead of delegating to an existing method and catching its exceptions.
+ *
+ * @author Rob Spoor
+ * @since 1.1
+ */
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.SOURCE)
+@Documented
+public @interface NativeParsing {
+    // marker annotation
+}

src/main/java/com/github/robtimus/tryparse/ParseFunction.java

@@ -0,0 +1,39 @@
+/*
+ * ParseFunction.java
+ * Copyright 2019 Rob Spoor
+ *
+ * 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.github.robtimus.tryparse;
+
+/**
+ * A function that parses one object into another.
+ *
+ * @author Rob Spoor
+ * @param <T> The type of object to parse.
+ * @param <R> The type of the parse result.
+ * @param <X> The type of exception that occurs if parsing fails.
+ * @since 1.1
+ */
+public interface ParseFunction<T, R, X extends Exception> {
+
+    /**
+     * Parses an object.
+     *
+     * @param input The object to parse.
+     * @return The parsed object.
+     * @throws X If parsing fails.
+     */
+    R parse(T input) throws X;
+}