Class ClearQuery

java.lang.Object
xyz.krmentos.adofaigg.query.ClearQuery

public class ClearQuery extends Object
이 클래스는 Adofai.gg API에서 사용되는 클리어 데이터를 필터링하기 위한 클래스입니다.

ClearQuery를 사용하여 클리어 데이터를 특정 조건에 맞게 필터링할 수 있습니다.

다양한 메서드를 통해 각 필터 조건을 설정하고, checkClear(ClearData...) 메서드를 호출하여 필터링된 클리어 데이터를 얻을 수 있습니다.

See Also:
  • Constructor Details

    • ClearQuery

      public ClearQuery()
  • Method Details

    • setName

      public ClearQuery setName(String name)
      클리어 데이터의 이름을 설정합니다.
      Parameters:
      name - 설정할 클리어 데이터의 이름입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      NullPointerException - 값이 null일 경우 예외가 발생합니다.
    • setUserCode

      public ClearQuery setUserCode(int userCode)
      클리어 데이터의 사용자 코드를 설정합니다.
      Parameters:
      userCode - 설정할 클리어 데이터의 사용자 코드입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setMapId

      public ClearQuery setMapId(int mapId)
      클리어 데이터의 맵 ID를 설정합니다.
      Parameters:
      mapId - 설정할 클리어 데이터의 맵 ID입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setSpeed

      public ClearQuery setSpeed(int speed)
      클리어 데이터의 속도를 설정합니다.
      Parameters:
      speed - 설정할 클리어 데이터의 속도입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setSpeed

      public ClearQuery setSpeed(int minSpeed, int maxSpeed)
      클리어 데이터의 속도 범위를 설정합니다.
      Parameters:
      minSpeed - 최소 속도 값입니다.
      maxSpeed - 최대 속도 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작거나 최소값이 최대값보다 큰 경우 발생합니다.
    • setMinSpeed

      public ClearQuery setMinSpeed(int minSpeed)
      클리어 데이터의 최소 속도 범위를 설정합니다.
      Parameters:
      minSpeed - 최소 속도 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setMaxSpeed

      public ClearQuery setMaxSpeed(int maxSpeed)
      클리어 데이터의 최대 속도 범위를 설정합니다.
      Parameters:
      maxSpeed - 최대 속도 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setXAccuracy

      public ClearQuery setXAccuracy(double xAccuracy)
      클리어 데이터의 절대 정확도를 설정합니다.
      Parameters:
      xAccuracy - 설정할 클리어 데이터의 절대 정확도입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작거나 값이 100보다 클경우 경우 예외가 발생합니다.
    • setXAccuracy

      public ClearQuery setXAccuracy(double minXAccuracy, double maxXAccuracy)
      클리어 데이터의 절대 정확도 범위를 설정합니다.
      Parameters:
      minXAccuracy - 설정할 절대 정확도의 최소값입니다.
      maxXAccuracy - 설정할 절대 정확도의 최대값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작거나 값이 100보다 크거나 최소값이 최대값보다 큰 경우 예외가 발생합니다.
    • setMinXAccuracy

      public ClearQuery setMinXAccuracy(double minXAccuracy)
      클리어 데이터의 최소 절대 정확도 범위를 설정합니다.
      Parameters:
      minXAccuracy - 최소 절대 정확도 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작거나 값이 100보다 클경우 경우 예외가 발생합니다.
    • setMaxXAccuracy

      public ClearQuery setMaxXAccuracy(double maxXAccuracy)
      클리어 데이터의 최대 절대 정확도 범위를 설정합니다.
      Parameters:
      maxXAccuracy - 최대 절대 정확도 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작거나 값이 100보다 클경우 경우 예외가 발생합니다.
    • setPlayPoint

      public ClearQuery setPlayPoint(double playPoint)
      클리어 데이터의 PP를 설정합니다.
      Parameters:
      playPoint - 설정할 클리어 데이터의 PP입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setPlayPoint

      public ClearQuery setPlayPoint(double minPlayPoint, double maxPlayPoint)
      클리어 데이터의 PP 범위를 설정합니다.
      Parameters:
      minPlayPoint - 최소 PP 값입니다.
      maxPlayPoint - 최대 PP 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작거나 최소값이 최대값보다 큰 경우 발생합니다.
    • setMinPlayPoint

      public ClearQuery setMinPlayPoint(double minPlayPoint)
      클리어 데이터의 최소 PP 범위를 설정합니다.
      Parameters:
      minPlayPoint - 최소 PP 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setMaxPlayPoint

      public ClearQuery setMaxPlayPoint(double maxPlayPoint)
      클리어 데이터의 최대 PP 범위를 설정합니다.
      Parameters:
      maxPlayPoint - 최대 PP 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setLocalRank

      public ClearQuery setLocalRank(int localRank)
      클리어 데이터의 LocalRank를 설정합니다.
      Parameters:
      localRank - 설정할 클리어 데이터의 LocalRank입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setLocalRank

      public ClearQuery setLocalRank(int minLocalRank, int maxLocalRank)
      클리어 데이터의 LocalRank 범위를 설정합니다.
      Parameters:
      minLocalRank - 최소 LocalRank 값입니다.
      maxLocalRank - 최대 LocalRank 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작거나 최소값이 최대값보다 큰 경우 발생합니다.
    • setMinLocalRank

      public ClearQuery setMinLocalRank(int minLocalRank)
      클리어 데이터의 최소 LocalRank 범위를 설정합니다.
      Parameters:
      minLocalRank - 최소 LocalRank 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setMaxLocalRank

      public ClearQuery setMaxLocalRank(int maxLocalRank)
      클리어 데이터의 최대 LocalRank 범위를 설정합니다.
      Parameters:
      maxLocalRank - 최대 LocalRank 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setSongRank

      public ClearQuery setSongRank(int songRank)
      클리어 데이터의 SongRank를 설정합니다.
      Parameters:
      songRank - 설정할 클리어 데이터의 SongRank입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setSongRank

      public ClearQuery setSongRank(int minSongRank, int maxSongRank)
      클리어 데이터의 SongRank 범위를 설정합니다.
      Parameters:
      minSongRank - 최소 SongRank 값입니다.
      maxSongRank - 최대 SongRank 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작거나 최소값이 최대값보다 큰 경우 발생합니다.
    • setMinSongRank

      public ClearQuery setMinSongRank(int minSongRank)
      클리어 데이터의 최소 SongRank 범위를 설정합니다.
      Parameters:
      minSongRank - 최소 SongRank 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setMaxSongRank

      public ClearQuery setMaxSongRank(int maxSongRank)
      클리어 데이터의 최대 SongRank 범위를 설정합니다.
      Parameters:
      maxSongRank - 최대 SongRank 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setTotalRank

      public ClearQuery setTotalRank(int totalRank)
      클리어 데이터의 TotalRank를 설정합니다.
      Parameters:
      totalRank - 설정할 클리어 데이터의 TotalRank입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setTotalRank

      public ClearQuery setTotalRank(int minTotalRank, int maxTotalRank)
      클리어 데이터의 TotalRank 범위를 설정합니다.
      Parameters:
      minTotalRank - 최소 TotalRank 값입니다.
      maxTotalRank - 최대 TotalRank 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작거나 최소값이 최대값보다 큰 경우 발생합니다.
    • setMinTotalRank

      public ClearQuery setMinTotalRank(int minTotalRank)
      클리어 데이터의 최소 TotalRank 범위를 설정합니다.
      Parameters:
      minTotalRank - 최소 TotalRank 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • setMaxTotalRank

      public ClearQuery setMaxTotalRank(int maxTotalRank)
      클리어 데이터의 최대 TotalRank 범위를 설정합니다.
      Parameters:
      maxTotalRank - 최대 TotalRank 값입니다.
      Returns:
      ClearQuery 개체 자신을 반환합니다.
      Throws:
      IllegalArgumentException - 값이 0보다 작을 경우 예외가 발생합니다.
    • checkClear

      public List<ClearData> checkClear(ClearData... clearData)
      클리어 데이터를 필터링하여 설정된 조건에 맞는 데이터를 반환합니다.
      Parameters:
      clearData - 클리어 데이터 배열입니다.
      Returns:
      조건에 맞는 클리어 데이터의 목록입니다.