/lib/twitter_api_me-1.6/src/com/twitterapime/search/Query.java

https://bitbucket.org/gnorris1/twitter-me · Java · 79 lines · 30 code · 6 blank · 43 comment · 9 complexity · 0c17a3060a57354d1eb718d1c6319beb MD5 · raw file 

    

  1. /*

    2. 

  2.  * Query.java

    3. 

  3.  * 16/08/2009

    4. 

  4.  * Twitter API Micro Edition

    5. 

  5.  * Copyright(c) Ernandes Mourao Junior (ernandes@gmail.com)

    6. 

  6.  * All rights reserved

    7. 

  7.  */

    8. 

  8. package com.twitterapime.search;

    9. 

  9. 

    10. 

  10. import java.io.UnsupportedEncodingException;

    11. 

  11. 

    12. 

  12. /**

    13. 

  13.  * <p>

    14. 

  14.  * This class defines a structure of a query. A Query object represents a query

    15. 

  15.  * statement that is sent to Twitter Search API, so that it can return all the

    16. 

  16.  * tweets that match a criteria.

    17. 

  17.  * </p>

    18. 

  18.  * 

    19. 

  19.  * @author Ernandes Mourao Junior (ernandes@gmail.com)

    20. 

  20.  * @version 1.2

    21. 

  21.  * @since 1.0

    22. 

  22.  * @see QueryComposer

    23. 

  23.  * @see SearchDevice

    24. 

  24.  */

    25. 

  25. public final class Query {

    26. 

  26. 	/**

    27. 

  27. 	 * <p>

    28. 

  28. 	 * Hold the string that represents a query.

    29. 

  29. 	 * </p>

    30. 

  30. 	 */

    31. 

  31. 	private String query;

    32. 

  32. 

    33. 

  33. 	/**

    34. 

  34. 	 * <p>

    35. 

  35. 	 * Create an instance of Query class.

    36. 

  36. 	 * </p>

    37. 

  37. 	 * @param query The string of query.

    38. 

  38. 	 * @throws InvalidQueryException If query is not a valid UTF-8 string.

    39. 

  39. 	 * @throws IllegalArgumentException If query is null.

    40. 

  40. 	 */

    41. 

  41. 	public Query(String query) {

    42. 

  42. 		if (query == null) {

    43. 

  43. 			throw new IllegalArgumentException("Query must not be null.");

    44. 

  44. 		}

    45. 

  45. 		//

    46. 

  46. 		try {

    47. 

  47. 			this.query = new String(query.getBytes(), "UTF-8");

    48. 

  48. 		} catch (UnsupportedEncodingException e) {

    49. 

  49. 			throw new InvalidQueryException("Invalid UTF-8 string: " + query);

    50. 

  50. 		}

    51. 

  51. 	}

    52. 

  52. 

    53. 

  53. 	/**

    54. 

  54. 	 * @see java.lang.Object#equals(java.lang.Object)

    55. 

  55. 	 */

    56. 

  56. 	public boolean equals(Object o) {

    57. 

  57. 		if (o == this) {

    58. 

  58. 			return true;

    59. 

  59. 		} else if (o == null || !(o instanceof Query)) {

    60. 

  60. 			return false;

    61. 

  61. 		} else {

    62. 

  62. 			return query.equals(((Query)o).query);

    63. 

  63. 		}

    64. 

  64. 	}

    65. 

  65. 	

    66. 

  66. 	/**

    67. 

  67. 	 * @see java.lang.Object#hashCode()

    68. 

  68. 	 */

    69. 

  69. 	public int hashCode() {

    70. 

  70. 		return query.hashCode();

    71. 

  71. 	}

    72. 

  72. 

    73. 

  73. 	/**

    74. 

  74. 	 * @see java.lang.Object#toString()

    75. 

  75. 	 */

    76. 

  76. 	public String toString() {

    77. 

  77. 		return query;

    78. 

  78. 	}

    79. 

  79. }
    80.