Sheldan/abstracto
1
0
Fork 0
mirror of https://github.com/Sheldan/abstracto.git synced 2026-04-14 03:45:57 +00:00
Code Issues Packages Projects Releases Wiki Activity

[AB-xx] fixing javadoc

Browse Source
This commit is contained in:
Sheldan
2022-10-16 13:16:50 +02:00
parent ce90370b9c
commit e6802a0851
15 changed files with 26 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
abstracto-application/abstracto-modules/statistic/statistic-impl/src/main/java/dev/sheldan/abstracto/statistic/emote/command/SyncTrackedEmotes.java
View File

@@ -22,7 +22,7 @@ import java.util.concurrent.CompletableFuture;
/**
* This command can be used to synchronize the state of {@link dev.sheldan.abstracto.statistic.emote.model.database.TrackedEmote}
* in the database, with the state of {@link net.dv8tion.jda.api.entities.Emote} in the {@link net.dv8tion.jda.api.entities.Guild}.
* in the database, with the state of emote in the {@link net.dv8tion.jda.api.entities.Guild}.
* It will mark emotes not in the guild anymore and add emotes which are not yet tracked.
*/
@Component

2
abstracto-application/abstracto-modules/statistic/statistic-impl/src/main/java/dev/sheldan/abstracto/statistic/emote/command/TrackEmote.java
View File

@@ -25,7 +25,7 @@ import java.util.List;
/**
* This command can be used to track one individual {@link TrackedEmote} newly, or set the emote to be tracked again.
* This can either be done via providing the {@link net.dv8tion.jda.api.entities.Emote} or via ID.
* This can either be done via providing the emote or via ID.
*/
@Component
public class TrackEmote extends AbstractConditionableCommand {

4
abstracto-application/abstracto-modules/statistic/statistic-impl/src/main/java/dev/sheldan/abstracto/statistic/emote/repository/UsedEmoteRepository.java
View File

@@ -21,8 +21,8 @@ public interface UsedEmoteRepository extends JpaRepository<UsedEmote, UsedEmoteD
/**
* Selects the {@link UsedEmote} for one particular {@link dev.sheldan.abstracto.statistic.emote.model.database.TrackedEmote}
* for the current date.
* @param emoteId The ID of the {@link net.dv8tion.jda.api.entities.Emote} which is being tracked
* @param server_id The ID of the {@link net.dv8tion.jda.api.entities.Guild} which is the server where the {@link net.dv8tion.jda.api.entities.Emote}
* @param emoteId The ID of the emote which is being tracked
* @param server_id The ID of the {@link net.dv8tion.jda.api.entities.Guild} which is the server where the emote
* is being tracked
* @return An {@link Optional} containing a possible {@link UsedEmote}, if it exists for the criteria, an empty Optional otherwise.
*/

2
abstracto-application/abstracto-modules/statistic/statistic-impl/src/main/java/dev/sheldan/abstracto/statistic/emote/service/TrackedEmoteRunTimeStorage.java
View File

@@ -19,7 +19,7 @@ public class TrackedEmoteRunTimeStorage {
* map will not contain many keys, because the {@link dev.sheldan.abstracto.statistic.emote.job.EmotePersistingJob}
* will remove them a minute later. The Map within the current minute will contain every server as a key in which
* there were emotes used in the particular minute. {@link PersistingEmote} does not contain any JDA related objects
* but only the information necessary to identify any {@link net.dv8tion.jda.api.entities.Emote}.
* but only the information necessary to identify any emote.
*/
private HashMap<Long, Map<Long, List<PersistingEmote>>> trackedEmotes = new HashMap<>();

12
abstracto-application/abstracto-modules/statistic/statistic-int/src/main/java/dev/sheldan/abstracto/statistic/emote/model/PersistingEmote.java
View File

@@ -13,15 +13,15 @@ import lombok.Setter;
@Builder
public class PersistingEmote {
/**
* The global unique ID of the {@link net.dv8tion.jda.api.entities.Emote}
* The global unique ID of the emote
*/
private Long emoteId;
/**
* The name of the {@link net.dv8tion.jda.api.entities.Emote} in Discord
* The name of the emote in Discord
*/
private String emoteName;
/**
* Whether or not the {@link net.dv8tion.jda.api.entities.Emote} is animated
* Whether or not the emote is animated
*/
private Boolean animated;
/**
@@ -30,15 +30,15 @@ public class PersistingEmote {
*/
private Boolean external;
/**
* Only if the emote is external: the URL where the source image of the {@link net.dv8tion.jda.api.entities.Emote} is stored on Discord servers
* Only if the emote is external: the URL where the source image of the emote is stored on Discord servers
*/
private String externalUrl;
/**
* The amount of times the {@link net.dv8tion.jda.api.entities.Emote} has been used.
* The amount of times the emote has been used.
*/
private Long count;
/**
* The ID of the {@link net.dv8tion.jda.api.entities.Guild} on which the {@link net.dv8tion.jda.api.entities.Emote} has been used on
* The ID of the {@link net.dv8tion.jda.api.entities.Guild} on which the emote has been used on
*/
private Long serverId;
}

2
abstracto-application/abstracto-modules/statistic/statistic-int/src/main/java/dev/sheldan/abstracto/statistic/emote/model/database/TrackedEmote.java
View File

@@ -34,7 +34,7 @@ public class TrackedEmote implements Serializable, Fakeable {
private AServer server;
/**
* The name of the {@link net.dv8tion.jda.api.entities.Emote} which is the same how it is identified within Discord.
* The name of the emote which is the same how it is identified within Discord.
*/
@Column(name = "name", length = 32)
private String emoteName;

8
abstracto-application/abstracto-modules/statistic/statistic-int/src/main/java/dev/sheldan/abstracto/statistic/emote/service/UsedEmoteService.java
View File

@@ -16,7 +16,7 @@ public interface UsedEmoteService {
* This {@link EmoteStatsModel} will contain all {@link TrackedEmote} from the server
* @param server The {@link AServer} to retrieve the emote stats for
* @param since Emote stats should be younger than this {@link Instant}. Only the date portion is considered.
* @return An {@link EmoteStatsModel} containing the statistics split by animated and static {@link net.dv8tion.jda.api.entities.Emote}
* @return An {@link EmoteStatsModel} containing the statistics split by animated and static emote
*/
EmoteStatsModel getEmoteStatsForServerSince(AServer server, Instant since);
@@ -25,7 +25,7 @@ public interface UsedEmoteService {
* This {@link EmoteStatsModel} will contain only deleted {@link TrackedEmote} from the server
* @param server The {@link AServer} to retrieve the emote stats for
* @param since Emote stats should be younger than this {@link Instant}. Only the date portion is considered.
* @return An {@link EmoteStatsModel} containing the statistics split by animated and static {@link net.dv8tion.jda.api.entities.Emote}
* @return An {@link EmoteStatsModel} containing the statistics split by animated and static emote
*/
EmoteStatsModel getDeletedEmoteStatsForServerSince(AServer server, Instant since);
@@ -34,7 +34,7 @@ public interface UsedEmoteService {
* This {@link EmoteStatsModel} will contain only external {@link TrackedEmote} from the server
* @param server The {@link AServer} to retrieve the emote stats for
* @param since Emote stats should be younger than this {@link Instant}. Only the date portion is considered.
* @return An {@link EmoteStatsModel} containing the statistics split by animated and static {@link net.dv8tion.jda.api.entities.Emote}
* @return An {@link EmoteStatsModel} containing the statistics split by animated and static emote
*/
EmoteStatsModel getExternalEmoteStatsForServerSince(AServer server, Instant since);
@@ -44,7 +44,7 @@ public interface UsedEmoteService {
* the {@link net.dv8tion.jda.api.entities.Guild}
* @param server The {@link AServer} to retrieve the emote stats for
* @param since Emote stats should be younger than this {@link Instant}. Only the date portion is considered.
* @return An {@link EmoteStatsModel} containing the statistics split by animated and static {@link net.dv8tion.jda.api.entities.Emote}
* @return An {@link EmoteStatsModel} containing the statistics split by animated and static emote
*/
EmoteStatsModel getActiveEmoteStatsForServerSince(AServer server, Instant since);
EmoteStatsResultDisplay getEmoteStatForEmote(TrackedEmote trackedEmote, Instant since);