zdm/undo-redo
Archived
3
Fork 0
Code Issues 2 Pull Requests Releases 1 Activity

Basic API Structure #2

Merged
kske merged 12 commits from f/basics into develop 2021-12-11 21:45:59 +01:00
Conversation 1 Commits 12 Files Changed 15 +18 -14
1 changed files with 18 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit acb25c3120 - Show all commits

32
src/main/java/dev/kske/undoredo/ChangeManager.java
View File

@ -3,7 +3,11 @@ package dev.kske.undoredo;
import java.util.*;
/**
kske marked this conversation as resolved Outdated
kske commented 2021-12-07 21:13:37 +01:00
Outdated
Review
Copy Link

The main description of the class is missing. I suggest something along the lines of:

"A change manager keeps track of subsequent changes and allows un- and redoing them. A specific position can be marked using {@link ...} to keep track of a saved state in the application that uses the manager."

The main description of the class is missing. I suggest something along the lines of: "A change manager keeps track of subsequent changes and allows un- and redoing them. A specific position can be marked using {@link ...} to keep track of a saved state in the application that uses the manager."
* @param <C> the change types to store in this change manager
* A change manager keeps track of subsequent changes and allows un- and redoing them. A specific
kske marked this conversation as resolved Outdated
kske commented 2021-12-07 21:10:15 +01:00
Outdated
Review
Copy Link

Replace types by type, as the user only specifies one parameter.

Replace `types` by `type`, as the user only specifies one parameter.
* change can be marked using {@link #mark()} to keep track of a saved state in the application that
* uses the manager.
*
* @param <C> the change type to store in this change manager
* @author Maximilian K&auml;fer
* @since 0.0.1
*/
@ -15,8 +19,8 @@ public final class ChangeManager<C extends Change> {
private int markedIndex;
/**
* Adds a change to the changes list.
*
* Applies the given change and appends it to the change list.
*
* @param change the change to add
* @since 0.0.1
*/
@ -26,9 +30,9 @@ public final class ChangeManager<C extends Change> {
}
kske marked this conversation as resolved Outdated
kske commented 2021-12-07 21:18:20 +01:00
Outdated
Review
Copy Link

"whether an action was performed"

"whether an action was performed"
/**
* Undoes the change at the current index position.
*
* @return whether the operation could be executed due to one being currently available
* Undoes the current change.
*
* @return whether an action was performed
* @since 0.1.0
*/
public boolean undo() {
@ -42,8 +46,8 @@ public final class ChangeManager<C extends Change> {
kske marked this conversation as resolved Outdated
kske commented 2021-12-07 21:18:55 +01:00
Outdated
Review
Copy Link

"whether an action was performed"

"whether an action was performed"
/**
* Applies the change that was undone before.
*
* @return whether the operation could be executed due to one being currently available
*
* @return whether an action was performed
* @since 0.0.1
*/
public boolean redo() {
@ -56,8 +60,8 @@ public final class ChangeManager<C extends Change> {
}
/**
* Marks the current index.
*
* Marks the current change.
*
* @since 0.0.1
*/
public void mark() {
@ -65,7 +69,7 @@ public final class ChangeManager<C extends Change> {
}
/**
* @return whether the current index was marked
* @return whether the current change is marked
* @since 0.0.1
*/
public boolean isAtMarkedIndex() {
@ -73,7 +77,7 @@ public final class ChangeManager<C extends Change> {
}
/**
* @return whether the undo operation is currently available
* @return whether a change is present that can be undone
* @since 0.0.1
*/
public boolean isUndoAvailable() {
@ -81,7 +85,7 @@ public final class ChangeManager<C extends Change> {
}
/**
* @return whether the redo operation is currently available.
* @return whether a change is present that can be redone
* @since 0.0.1
*/
public boolean isRedoAvailable() {
@ -90,7 +94,7 @@ public final class ChangeManager<C extends Change> {
/**
* Provides an unmodifiable view of the changes stored in this change manager.
*
*
* @return all stored changes
* @since 0.0.1
*/