improved Javadoc in some files, especially UIColors

This commit is contained in:
delvh 2019-11-22 22:40:00 +01:00
parent 92fb3d706c
commit 7dc7ec385c
3 changed files with 20 additions and 52 deletions

View File

@ -129,7 +129,9 @@ public class Client {
* Updating UserStatus of all users in LocalDB. (Server sends all users with
* their updated UserStatus to the client.) <br>
*
* @param userId
* @param userId the client who sends the sync
* @param sync the sync object (yet to be converted from java class to sync.xml)
* @return a returnSync.xml file
* @since Envoy v0.1-alpha
*/
public Sync sendSync(long userId, Sync sync) {

View File

@ -270,7 +270,7 @@ public class LocalDB {
/**
* Adds a user to the {@code sync} {@link Sync} object.
*
* @param user
* @param user the user who should be added to the {@link Sync} object
* @since Envoy v0.1-alpha
*/
public void addUserToSync(User user) { sync.getUsers().add(user); }

View File

@ -17,44 +17,10 @@ public class UIColors {
private UIColors() {}
/**
* This color is used for the general background where no other elements
* overlap.
*
* @since Envoy v0.2-alpha
*/
private Color backgroundColor;
/**
* This color is used as background for all areas where a user can interact with
* Envoy.
* (i.e. a JTextArea or JList)
*
* @since Envoy v0.2-alpha
*/
private Color userInteractionColor;
/**
* This color is used for any areas that need special attention.
* (i.e. highlighting a selected list column or a button background)
*
* @since Envoy v0.2-alpha
*/
private Color specialUseColor;
/**
* This color is the color in which text will be displayed.
*
* @since Envoy v0.2-alpha
*/
private Color textColor;
/**
* This object ensures that only one {@link UIColors} object exists.
*
* @since Envoy v0.2-alpha
*/
private static UIColors uIColors;
/**
@ -94,25 +60,29 @@ public class UIColors {
}
/**
* @return the {@link UIColors#backgroundColor}
* @return the general background color where no other element overlaps
* @since Envoy v0.2-alpha
*/
public Color getBackgroundColor() { return backgroundColor; }
/**
* @param backgroundColor the new {@link UIColors#backgroundColor}
* @param backgroundColor the general background where no other element overlaps
* @since Envoy v0.2-alpha
*/
public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; }
/**
* @return the {@link UIColors#userInteractionColor}
* @return the userInteractionColor:<br>
* This color is used as background for all areas where a user can
* interact with Envoy (i.e. a JTextArea or JList)
* @since Envoy v0.2-alpha
*/
public Color getUserInteractionColor() { return userInteractionColor; }
/**
* @param userInteractionColor the new {@link UIColors#userInteractionColor}
* @param userInteractionColor This color is used as background for all areas <br>
* where a user can interact with Envoy
* (i.e. a JTextArea or JList)
* @since Envoy v0.2-alpha
*/
public void setUserInteractionColor(Color userInteractionColor) {
@ -120,39 +90,35 @@ public class UIColors {
}
/**
* @return the {@link UIColors#specialUseColor}
* @return specialUseColor: This color is used for any areas that need special attention.<br>
* (i.e. highlighting a selected list column or a button background)
* @since Envoy v0.2-alpha
*/
public Color getSpecialUseColor() { return specialUseColor; }
/**
* @param specialUseColor the new {@link UIColors#specialUseColor}
* @param specialUseColor This color is used for any areas that need special attention.<br>
* (i.e. highlighting a selected list column or a button background)
* @since Envoy v0.2-alpha
*/
public void setSpecialUseColor(Color specialUseColor) { this.specialUseColor = specialUseColor; }
/**
* @return the {@link UIColors#textColor}
* @return textColor: The color in which text will be displayed
* @since Envoy v0.2-alpha
*/
public Color getTextColor() { return textColor; }
/**
* @param textColor the new {@link UIColors#textColor}
* @param textColor The color in which text will be displayed
* @since Envoy v0.2-alpha
*/
public void setTextColor(Color textColor) { this.textColor = textColor; }
@Deprecated
/**
* @return the {@link UIColors#uIColors}
* @return the uiColors object
* @since Envoy v0.2-alpha
*/
public static UIColors getEnvoyColors() { return uIColors; }
@Deprecated
/**
* @param envoyColors the new {@link EnvoyColors#envoyColors}
* @since Envoy v0.2-alpha
*/
public static void setEnvoyColors(UIColors uIColors) { UIColors.uIColors = uIColors; }
}