Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Improve the code on throwing exceptions #52

Merged
merged 18 commits into from
Jun 24, 2023
Merged

Improve the code on throwing exceptions #52

Changes from 1 commit
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
a59ca9d
Improve the `raiseError` and `raiseErrorMsg`
mitsuki31 Jun 22, 2023
5cf9f61
Improve code on catching exceptions
mitsuki31 Jun 22, 2023
ff14d89
Added `cause` as private attribute
mitsuki31 Jun 22, 2023
7c576a3
Remove the duplicate `cause` variables
mitsuki31 Jun 22, 2023
79cf264
Remove try-catch on `create` method
mitsuki31 Jun 22, 2023
c7a7ff4
Remove try-catch on `select` method
mitsuki31 Jun 23, 2023
2f37a56
Remove try-catch on `change` methods
mitsuki31 Jun 23, 2023
0857039
Remove try-catch on `sum` methods
mitsuki31 Jun 23, 2023
b67f3a7
Remove try-catch on `sub` methods
mitsuki31 Jun 23, 2023
5ebc23f
Remove try-catch on `mult` methods
mitsuki31 Jun 23, 2023
9f95d4d
Remove try-catch on `transpose` methods
mitsuki31 Jun 23, 2023
304a555
Remove try-catch on `display` methods
mitsuki31 Jun 24, 2023
f5e0196
Remove try-catch on several methods
mitsuki31 Jun 24, 2023
ff6a18f
Remove try-catch on `get` method
mitsuki31 Jun 24, 2023
d33d061
Merge branch 'master' into develop
mitsuki31 Jun 24, 2023
7544291
Update the version (forced)
mitsuki31 Jun 24, 2023
954a041
Update the version
mitsuki31 Jun 24, 2023
4269773
Update the version
mitsuki31 Jun 24, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
158 changes: 85 additions & 73 deletions src/main/java/com/mitsuki/jmatrix/util/Options.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,22 +11,22 @@
import java.util.List;
import java.util.Arrays;

import java.lang.NullPointerException;
import java.lang.IllegalArgumentException;

// -**- Local Package -**- //
import com.mitsuki.jmatrix.core.JMBaseException;
import com.mitsuki.jmatrix.util.XMLParser;

/**
* This class provides all requirements for <b>JMatrix</b> package.<br>
*
* @version 1.1
* @since 1.0.0
* @author Ryuu Mitsuki
*
* @see com.mitsuki.jmatrix.util.XMLParser
*/
* This class provides all requirements for <b>JMatrix</b> library.
*
* @author <a href="https://github.com/mitsuki31" target="_blank">
* Ryuu Mitsuki</a>
* @version 1.2, 22 June 2023
* @since 1.0.0
* @license <a href="https://www.apache.org/licenses/LICENSE-2.0" target="_blank">
* Apache License 2.0</a>
*
* @see com.mitsuki.jmatrix.util.XMLParser
*/
public class Options
{
/**
Expand Down Expand Up @@ -470,87 +470,99 @@ public static boolean writeToFile(String filePath, String[ ] contents) {
///// --------------------- /////

/**
* Raises an error or exception and prints the stack trace of the
* input exception object and then exits the program (default exit code: 1).<br>
*
* @param ex the {@code Exception} object to be printed.
*
* @since 1.0.0
* @see #raiseError(Exception, int)
* @see #raiseErrorMsg(Exception)
* @see java.lang.Exception
* @see java.lang.Exception#printStackTrace
*/
public static final void raiseError(final Exception ex) {
ex.printStackTrace();
* Raises an error or exception and prints the stack traces of the
* input {@link Throwable} object and then exits the program (default exit code: 1).
*
* @param cause the {@link Throwable} object.
*
* @since 1.0.0
* @see #raiseError(Exception, int)
* @see #raiseErrorMsg(Exception)
* @see java.lang.Throwable
* @see java.lang.Throwable#printStackTrace
*/
final public static void raiseError(final Throwable cause) {
Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed the raiseError parameter from Exception ex to Throwable cause, so it can be used by any type of exceptions either RuntimeException and Exception.

This also changed on these following methods:

  • raiseError(Exception, int) -> raiseError(Throwable, int)
  • raiseErrorMsg(Exception) -> raiseErrorMsg(Throwable)
  • raiseErrorMsg(Exception, int) -> raiseErrorMsg(Throwable, int)

cause.printStackTrace();
System.err.println(System.lineSeparator() +
"Exited with error code: 1");
System.exit(1);
}

/**
* Raises an error or exception and prints the stack trace of the
* input exception object and then exits the program with the specified exit code.<br>
* Sets the {@code exitStatus} to {@code 0} (zero) if don't want the program to exits.<br>
*
* @param ex the {@code Exception} object to be printed.
* @param exitStatus the value that specifies the exit code.
*
* @since 1.0.0
* @see #raiseError(Exception)
* @see #raiseErrorMsg(Exception, int)
* @see java.lang.Exception
* @see java.lang.Exception#printStackTrace
*/
public static final void raiseError(final Exception ex, final int exitStatus) {
ex.printStackTrace();
if (exitStatus != 0) {
* Raises an error or exception and prints the stack traces of the
* input {@link Throwable} object and then exits the program with the specified exit code.
*
* <p>Set the {@code errno} to {@code 0} (zero) if want the program to continue runs
* even the exception traces has been printed.
*
* @param cause the {@link Throwable} object.
* @param errno the value that specifies the exit code,
* zero for continue running after prints the exception.
*
* @since 1.0.0
* @see #raiseError(Throwable)
* @see #raiseErrorMsg(Throwable, int)
* @see java.lang.Throwable
* @see java.lang.Throwable#printStackTrace
*/
final public static void raiseError(final Throwable cause, final int errno) {
cause.printStackTrace();
if (errno != 0) {
System.err.printf(System.lineSeparator() +
"Exited with error code: %d%s", exitStatus, System.lineSeparator());
System.exit(exitStatus);
"Exited with error code: %d%s", errno, System.lineSeparator());
System.exit(errno);
}
}


/**
* Raises an error or exception but only prints the message
* and then exits the program (default exit code: 1).<br>
*
* @param ex the {@code Exception} object to prints the message.
*
* @since 1.0.0
* @see #raiseErrorMsg(Exception, int)
* @see #raiseError(Exception)
* @see java.lang.Exception
* @see java.lang.Exception#printStackTrace
*/
public static final void raiseErrorMsg(final Exception ex) {
System.err.printf("[%s] Error: %s%s", PROGNAME, ex.getMessage(), System.lineSeparator());
* Raises an error or exception but only prints its message
* and then exits the program (default exit code: 1).
*
* <p>This method only prints the message of given {@link Throwable}
* object, if want the traces also get printed use {@link #raiseError(Throwable)} instead.
*
* @param cause the {@link Throwable} object.
*
* @since 1.0.0
* @see #raiseErrorMsg(Throwable, int)
* @see #raiseError(Throwable)
* @see java.lang.Throwable
* @see java.lang.Throwable#printStackTrace
*/
final public static void raiseErrorMsg(final Throwable cause) {
System.err.printf("[%s] Error: %s%s", PROGNAME, cause.getMessage(), System.lineSeparator());
System.err.println(System.lineSeparator() +
"Exited with error code: 1");
System.exit(1);
}

/**
* Raises an error or exception but only prints the message
* and then exits the program with the specified exit code.<br>
* Sets the {@code exitStatus} to {@code 0} (zero) if don't want the program to exits.<br>
*
* @param ex the {@code Exception} object to prints the message.
* @param exitStatus the value that specifies the exit code.
*
* @since 1.0.0
* @see #raiseErrorMsg(Exception)
* @see #raiseError(Exception, int)
* @see java.lang.Exception
* @see java.lang.Exception#printStackTrace
*/
public static final void raiseErrorMsg(final Exception ex, final int exitStatus) {
System.err.printf("[%s] Error: %s%s", PROGNAME, ex.getMessage(), System.lineSeparator());
if (exitStatus != 0) {
* Raises an error or exception but only prints its message
* and then exits the program with the specified exit code.
*
* <p>Set the {@code errno} to {@code 0} (zero) if want the program to continue runs
* even the exception traces has been printed.
*
* <p>This method only prints the message of given {@link Throwable}
* object, if want the traces also get printed use {@link #raiseError(Throwable, int)} instead.
*
* @param cause the {@link Throwable} object.
* @param errno the value that specifies the exit code,
* zero for continue running after prints the exception.
*
* @since 1.0.0
* @see #raiseErrorMsg(Throwable)
* @see #raiseError(Throwable, int)
* @see java.lang.Throwable
* @see java.lang.Throwable#printStackTrace
*/
final public static void raiseErrorMsg(final Throwable cause, final int errno) {
System.err.printf("[%s] Error: %s%s", PROGNAME, cause.getMessage(), System.lineSeparator());
if (errno != 0) {
System.err.printf(System.lineSeparator() +
"Exited with error code: %d%s", exitStatus, System.lineSeparator());
System.exit(exitStatus);
"Exited with error code: %d%s", errno, System.lineSeparator());
System.exit(errno);
}
}
}