Upstream/Plan
1
0
Fork 0
mirror of https://github.com/plan-player-analytics/Plan.git synced 2025-01-02 14:37:45 +01:00
Code Issues Projects Releases Wiki Activity

Updated javadoc of extension queries

Browse Source 
Some of them were for wrong class and contained
lots of unnecessary or out of date information
This commit is contained in:
Rsl1122 2020-01-02 17:15:50 +02:00
parent 0a1c20c070
commit 3e734ec505
13 changed files with 51 additions and 76 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/MethodType.java
View File

@ -30,10 +30,6 @@ import java.util.UUID;
*/
public enum MethodType {
@Deprecated
PLAYER_UUID,
@Deprecated
PLAYER_NAME,
PLAYER,
GROUP,
SERVER;

14
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionAggregateBooleansQuery.java
View File

@ -40,17 +40,15 @@ import java.util.UUID;
import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query aggregated boolean values from player value table.
* Query for selecting a percentage of true for each boolean provided for players.
* <p>
* Returns Map: PluginID - ExtensionServerData.Factory.
* Returns Map: PluginID - {@link ExtensionData.Builder}.
* <p>
* How it is done:
* - Combines three queries, one that selects true boolean count, one that selects boolean value count and one that selects provider information.
* - Data query is sorted into a multi-map: PluginID - Tab Name - Tab Data
* - (Tab Name can be empty.)
* - Multi-map is sorted into ExtensionPlayerData objects by PluginID, one per ID
* <p>
* There are multiple data extraction methods to make extracting the value query easier.
* 1. Query count of boolean values
* 2. Query count of boolean=true
* 3. Combine with provider information
* 4. Map into ExtensionData objects by PluginID, one per ID
*
* @author Rsl1122
*/

13
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionAggregateDoublesQuery.java
View File

@ -40,17 +40,14 @@ import java.util.UUID;
import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query aggregated boolean values from player value table.
* Query for selecting average and total for each double value provided for players.
* <p>
* Returns Map: PluginID - ExtensionServerData.Factory.
* Returns Map: PluginID - {@link ExtensionData.Builder}.
* <p>
* How it is done:
* - Combines three queries, one that selects true boolean count, one that selects boolean value count and one that selects provider information.
* - Data query is sorted into a multi-map: PluginID - Tab Name - Tab Data
* - (Tab Name can be empty.)
* - Multi-map is sorted into ExtensionPlayerData objects by PluginID, one per ID
* <p>
* There are multiple data extraction methods to make extracting the value query easier.
* 1. Query averages and totals
* 2. Join with provider information query
* 3. Map into ExtensionData objects by PluginID, one per ID
*
* @author Rsl1122
*/

9
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionAggregateGroupsQuery.java
View File

@ -38,9 +38,14 @@ import java.util.UUID;
import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query aggregated Group values from groups table.
* Query for selecting Tables out of groups for players.
* <p>
* Returns Map: PluginID - ExtensionServerData.Factory.
* Returns Map: PluginID - {@link ExtensionData.Builder}.
* <p>
* How it's done:
* 1. Query count for each group name
* 2. Join with provider information
* 3. Map to ExtensionData objects, one per Plugin ID
*
* @author Rsl1122
*/

13
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionAggregateNumbersQuery.java
View File

@ -41,17 +41,14 @@ import java.util.UUID;
import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query aggregated boolean values from player value table.
* Query for selecting average and total for each number value provided for players.
* <p>
* Returns Map: PluginID - ExtensionServerData.Factory.
* Returns Map: PluginID - {@link ExtensionData.Builder}.
* <p>
* How it is done:
* - Combines three queries, one that selects true boolean count, one that selects boolean value count and one that selects provider information.
* - Data query is sorted into a multi-map: PluginID - Tab Name - Tab Data
* - (Tab Name can be empty.)
* - Multi-map is sorted into ExtensionPlayerData objects by PluginID, one per ID
* <p>
* There are multiple data extraction methods to make extracting the value query easier.
* 1. Query averages and totals
* 2. Join with provider information query
* 3. Map into ExtensionData objects by PluginID, one per ID
*
* @author Rsl1122
*/

13
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionAggregatePercentagesQuery.java
View File

@ -40,17 +40,14 @@ import java.util.UUID;
import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query aggregated boolean values from player value table.
* Query for selecting average for each percentage value provided for players.
* <p>
* Returns Map: PluginID - ExtensionServerData.Factory.
* Returns Map: PluginID - {@link ExtensionData.Builder}.
* <p>
* How it is done:
* - Combines three queries, one that selects true boolean count, one that selects boolean value count and one that selects provider information.
* - Data query is sorted into a multi-map: PluginID - Tab Name - Tab Data
* - (Tab Name can be empty.)
* - Multi-map is sorted into ExtensionPlayerData objects by PluginID, one per ID
* <p>
* There are multiple data extraction methods to make extracting the value query easier.
* 1. Query averages
* 2. Join with provider information query
* 3. Map into ExtensionData objects by PluginID, one per ID
*
* @author Rsl1122
*/

13
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionPlayerDataQuery.java
View File

@ -44,14 +44,11 @@ import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
* <p>
* Returns Map: Server UUID - List of ExtensionData.
* <p>
* How it is done:
* - Two queries are run, one that fetches all extensions and one that fetches all data of the player.
* - Data query is sorted into a multi-map: PluginID - Tab Name - Tab Data
* - (Tab Name can be empty.)
* - Multi-map is sorted into ExtensionData objects by PluginID, one per ID
* - This map is sorted into final Map: Server UUID - List of ExtensionData at the highest level.
* <p>
* There are multiple data extraction methods to make extracting the value query easier.
* Following utilities are used to query the data more easily.
* - {@link ExtensionData.Builder}
* - {@link QueriedTabData}
* - {@link QueriedTables}
* These utilities allow combining incomplete information.
*
* @author Rsl1122
*/

2
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionPlayerGroupsQuery.java
View File

@ -42,7 +42,7 @@ import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query player's Groups by Plugin ID inside ExtensionData objects.
* <p>
* - Group names are represented as a String value, concatenated to a single one.
* - Group names are represented as a String value, concatenated to a single String, separated by ', '.
* - String values are placed into Tabs they belong to
* - Tabs are placed to plugin they belong to
* - The map is returned

12
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionPlayerTablesQuery.java
View File

@ -41,16 +41,12 @@ import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query player tables from tableprovider table.
* <p>
* Returns Map: PluginID - ExtensionData.Factory.
* Returns Map: PluginID - {@link ExtensionData.Builder}.
* <p>
* How it is done:
* - TableProviders are queried and formed into Table.Factory objects sorted into a multi-map: PluginID - TableID - Table.Factory
* - Table values are queried and merged into the above multimap
* - Data query is sorted into a multi-map: PluginID - Tab Name - Tab Data
* - (Tab Name can be empty.)
* - Multi-map is sorted into ExtensionData objects by PluginID, one per ID
* <p>
* There are multiple data extraction methods to make extracting the value query easier.
* 1. TableProviders are queried and formed into {@link Table.Factory} objects inside {@link QueriedTables}.
* 2. Table values are queried and merged
* 3. QueriedTables is mapped into ExtensionData objects by PluginID, one per ID
*
* @author Rsl1122
*/

18
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionServerDataQuery.java
View File

@ -36,19 +36,15 @@ import java.util.*;
import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query ExtensionServerData of a server.
* Query ExtensionData of a server.
* <p>
* Returns List of ExtensionServerData.
* Returns List of ExtensionData.
* <p>
* How it is done:
* - Two queries are run, one that fetches all extensions and one that fetches all data of the player.
* - Data query is sorted into a multi-map: PluginID - Tab Name - Tab Data
* - (Tab Name can be empty.)
* - Multi-map is sorted into ExtensionServerData objects by PluginID, one per ID
* - This map is combined with similar maps that contain aggregated player values
* - This map is sorted into List of ExtensionPlayerData at the highest level.
* <p>
* There are multiple data extraction methods to make extracting the value query easier.
* Following utilities are used to query the data more easily.
* - {@link ExtensionData.Builder}
* - {@link QueriedTabData}
* - {@link QueriedTables}
* These utilities allow combining incomplete information.
*
* @author Rsl1122
*/

2
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionServerPlayerDataTableQuery.java
View File

@ -39,7 +39,7 @@ import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query Extension data of x most recent players on a server.
* <p>
* Returns Map: Player UUID - ExtensionTabData (container for provider based data)
* Returns Map: Player UUID - {@link ExtensionTabData} (container for provider based data)
*
* @author Rsl1122
*/

12
Plan/common/src/main/java/com/djrapitops/plan/extension/implementation/storage/queries/ExtensionServerTablesQuery.java
View File

@ -38,16 +38,12 @@ import static com.djrapitops.plan.storage.database.sql.building.Sql.*;
/**
* Query server tables from tableprovider table.
* <p>
* Returns Map: PluginID - ExtensionServerData.Factory.
* Returns Map: PluginID - {@link ExtensionData.Builder}.
* <p>
* How it is done:
* - TableProviders are queried and formed into Table.Factory objects sorted into a multi-map: PluginID - TableID - Table.Factory
* - Table values are queried and merged into the above multimap
* - Data query is sorted into a multi-map: PluginID - Tab Name - Tab Data
* - (Tab Name can be empty.)
* - Multi-map is sorted into ExtensionServerData objects by PluginID, one per ID
* <p>
* There are multiple data extraction methods to make extracting the value query easier.
* 1. TableProviders are queried and formed into {@link Table.Factory} objects inside {@link QueriedTables}.
* 2. Table values are queried and merged
* 3. QueriedTables is mapped into ExtensionData objects by PluginID, one per ID
*
* @author Rsl1122
*/

2
Plan/common/src/main/java/com/djrapitops/plan/extension/table/TableAccessor.java
View File

@ -21,7 +21,7 @@ import com.djrapitops.plan.extension.icon.Color;
import com.djrapitops.plan.extension.icon.Icon;
/**
* Utility for accessing implementation variables inside Table.Factory object.
* Utility for accessing implementation variables inside {@link Table.Factory} object.
*
* @author Rsl1122
*/