github/jooq
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[jOOQ/jOOQ#16827] Add disclaimer about resolve not throwing exceptions

Browse Source
This commit is contained in:
Lukas Eder 2024-06-14 09:04:15 +02:00
parent 8636eac159
commit 8df4926f4f
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
jOOQ/src/main/java/org/jooq/Source.java
View File

@ -104,6 +104,11 @@ public final class Source {
* <li>A file system resource</li>
* <li>A non-resource string (see {@link #of(String)})
* </ul>
* <p>
* Note that if users expect a resource descriptor to resolve, but the
* resource is not found, instead of throwing an exception on
* {@link #reader()} or {@link #readString()}, this will just produce the
* input string again, as if {@link #of(String)} was called.
*/
public static final Source resolve(String string) {
return new Source(string, null, null, null, null, null, null, null, -1, true);
@ -119,6 +124,11 @@ public final class Source {
* <li>A file system resource</li>
* <li>A non-resource string (see {@link #of(String)})
* </ul>
* <p>
* Note that if users expect a resource descriptor to resolve, but the
* resource is not found, instead of throwing an exception on
* {@link #reader()} or {@link #readString()}, this will just produce the
* input string again, as if {@link #of(String)} was called.
*/
public static final Source resolve(String string, String charsetName) {
return new Source(string, null, charsetName, null, null, null, null, null, -1, true);
@ -134,6 +144,11 @@ public final class Source {
* <li>A file system resource</li>
* <li>A non-resource string (see {@link #of(String)})
* </ul>
* <p>
* Note that if users expect a resource descriptor to resolve, but the
* resource is not found, instead of throwing an exception on
* {@link #reader()} or {@link #readString()}, this will just produce the
* input string again, as if {@link #of(String)} was called.
*/
public static final Source resolve(String string, Charset charset) {
return new Source(string, null, null, charset, null, null, null, null, -1, true);
@ -149,6 +164,11 @@ public final class Source {
* <li>A file system resource</li>
* <li>A non-resource string (see {@link #of(String)})
* </ul>
* <p>
* Note that if users expect a resource descriptor to resolve, but the
* resource is not found, instead of throwing an exception on
* {@link #reader()} or {@link #readString()}, this will just produce the
* input string again, as if {@link #of(String)} was called.
*/
public static final Source resolve(String string, CharsetDecoder charsetDecoder) {
return new Source(string, null, null, null, charsetDecoder, null, null, null, -1, true);