File	Doc	Category	Size	Date	Package
TvContentRating.java	API Doc	Android 5.1 API	29782	Thu Mar 12 22:22:30 GMT 2015	android.media.tv

TvContentRating

• java.lang.Object

{@literal









































}

TvContentRating rating = TvContentRating.createRating(
"com.android.tv",
"US_TV",
"US_TV_PG",
"US_TV_D", "US_TV_L");

Fields Summary
private static final String	DELIMITER
private final String	mDomain
private final String	mRatingSystem
private final String	mRating
private final String[]	mSubRatings
private final int	mHashCode

Constructors Summary

private TvContentRating(String domain, String ratingSystem, String rating, String[] subRatings) Constructs a TvContentRating object from a given rating and sub-rating constants. param domain The string for domain of the content rating system such as "com.android.tv". param ratingSystem The rating system string such as "US_TV". param rating The content rating string such as "US_TV_PG". param subRatings The sub-rating strings such as "US_TV_D" and "US_TV_L". mDomain = domain; mRatingSystem = ratingSystem; mRating = rating; if (subRatings == null || subRatings.length == 0) { mSubRatings = null; } else { Arrays.sort(subRatings); mSubRatings = subRatings; } mHashCode = 31 * Objects.hash(mDomain, mRating) + Arrays.hashCode(mSubRatings);

Methods Summary
public final boolean	contains(android.media.tv.TvContentRating rating) Returns {@code true} if this rating has the same main rating as the specified rating and when this rating's sub-ratings contain the other's. For example, a {@code TvContentRating} object that represents TV-PG with S(Sexual content) and V(Violence) contains TV-PG, TV-PG/S, TV-PG/V and itself. param rating The {@link TvContentRating} to check. return {@code true} if this object contains {@code rating}, {@code false} otherwise. hide if (rating == null) { throw new IllegalArgumentException("rating cannot be null"); } if (!rating.getMainRating().equals(mRating)) { return false; } if (!rating.getDomain().equals(mDomain) || !rating.getRatingSystem().equals(mRatingSystem) || !rating.getMainRating().equals(mRating)) { return false; } List<String> subRatings = getSubRatings(); List<String> subRatingsOther = rating.getSubRatings(); if (subRatings == null && subRatingsOther == null) { return true; } else if (subRatings == null && subRatingsOther != null) { return false; } else if (subRatings != null && subRatingsOther == null) { return true; } else { return subRatings.containsAll(subRatingsOther); }
public static android.media.tv.TvContentRating	createRating(java.lang.String domain, java.lang.String ratingSystem, java.lang.String rating, java.lang.String subRatings) Creates a {@code TvContentRating} object with predefined content rating strings. param domain The domain string. For example, "com.android.tv". param ratingSystem The rating system string. For example, "US_TV". param rating The content rating string. For example, "US_TV_PG". param subRatings The sub-rating strings. For example, "US_TV_D" and "US_TV_L". return A {@code TvContentRating} object. throws IllegalArgumentException If {@code domain}, {@code ratingSystem} or {@code rating} is {@code null}. if (TextUtils.isEmpty(domain)) { throw new IllegalArgumentException("domain cannot be empty"); } if (TextUtils.isEmpty(ratingSystem)) { throw new IllegalArgumentException("ratingSystem cannot be empty"); } if (TextUtils.isEmpty(rating)) { throw new IllegalArgumentException("rating cannot be empty"); } return new TvContentRating(domain, ratingSystem, rating, subRatings);
public boolean	equals(java.lang.Object obj) if (!(obj instanceof TvContentRating)) { return false; } TvContentRating other = (TvContentRating) obj; if (mHashCode != other.mHashCode) { return false; } if (!TextUtils.equals(mDomain, other.mDomain)) { return false; } if (!TextUtils.equals(mRatingSystem, other.mRatingSystem)) { return false; } if (!TextUtils.equals(mRating, other.mRating)) { return false; } return Arrays.equals(mSubRatings, other.mSubRatings);
public java.lang.String	flattenToString() Returns a string that unambiguously describes the rating information contained in a {@code TvContentRating} object. One can later recover the object from this string through {@link #unflattenFromString}. return a string containing the rating information, which can later be stored in the database. see #unflattenFromString StringBuilder builder = new StringBuilder(); builder.append(mDomain); builder.append(DELIMITER); builder.append(mRatingSystem); builder.append(DELIMITER); builder.append(mRating); if (mSubRatings != null) { for (String subRating : mSubRatings) { builder.append(DELIMITER); builder.append(subRating); } } return builder.toString();
public java.lang.String	getDomain() Returns the domain of this {@code TvContentRating} object. return mDomain;
public java.lang.String	getMainRating() Returns the main rating of this {@code TvContentRating} object. return mRating;
public java.lang.String	getRatingSystem() Returns the rating system of this {@code TvContentRating} object. return mRatingSystem;
public java.util.List	getSubRatings() Returns the unmodifiable sub-rating string {@link List} of this {@code TvContentRating} object. if (mSubRatings == null) { return null; } return Collections.unmodifiableList(Arrays.asList(mSubRatings));
public int	hashCode() return mHashCode;
public static android.media.tv.TvContentRating	unflattenFromString(java.lang.String ratingString) Recovers a {@code TvContentRating} object from the string that was previously created from {@link #flattenToString}. param ratingString The string returned by {@link #flattenToString}. return the {@code TvContentRating} object containing the domain, rating system, rating and sub-ratings information encoded in {@code ratingString}. see #flattenToString if (TextUtils.isEmpty(ratingString)) { throw new IllegalArgumentException("ratingString cannot be empty"); } String[] strs = ratingString.split(DELIMITER); if (strs.length < 3) { throw new IllegalArgumentException("Invalid rating string: " + ratingString); } if (strs.length > 3) { String[] subRatings = new String[strs.length - 3]; System.arraycopy(strs, 3, subRatings, 0, subRatings.length); return new TvContentRating(strs[0], strs[1], strs[2], subRatings); } return new TvContentRating(strs[0], strs[1], strs[2], null);