• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Licensed to the Apache Software Foundation (ASF) under one or more
3  * contributor license agreements.  See the NOTICE file distributed with
4  * this work for additional information regarding copyright ownership.
5  * The ASF licenses this file to You under the Apache License, Version 2.0
6  * (the "License"); you may not use this file except in compliance with
7  * the License.  You may obtain a copy of the License at
8  *
9  *      http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  */
17 
18 package org.apache.commons.io;
19 
20 import java.io.IOException;
21 import java.io.UncheckedIOException;
22 import java.util.Objects;
23 
24 /**
25  * Helps use lambdas that throw {@link IOException} rethrow as {@link UncheckedIOException}.
26  *
27  * @since 2.12.0
28  */
29 class UncheckedIOExceptions {
30 
31     /**
32      * Creates a new UncheckedIOException for the given detail message.
33      * <p>
34      * This method exists because there is no String constructor in {@link UncheckedIOException}.
35      * </p>
36      *
37      * @param message the detail message.
38      * @return a new {@link UncheckedIOException}.
39      */
create(final Object message)40     public static UncheckedIOException create(final Object message) {
41         final String string = Objects.toString(message);
42         return new UncheckedIOException(string, new IOException(string));
43     }
44 
45     /**
46      * Creates a new UncheckedIOException for the given detail message.
47      * <p>
48      * This method exists because there is no String constructor in {@link UncheckedIOException}.
49      * </p>
50      * @param e cause the {@link IOException}.
51      * @param message the detail message.
52      *
53      * @return a new {@link UncheckedIOException}.
54      */
wrap(final IOException e, final Object message)55     public static UncheckedIOException wrap(final IOException e, final Object message) {
56         return new UncheckedIOException(Objects.toString(message), e);
57     }
58 
UncheckedIOExceptions()59     private UncheckedIOExceptions() {
60         // no instance
61     }
62 }
63