由于以上所有的四个 JobService 都在处理 Channel 对象,您似乎可以方便地使用 channelId 作为 jobId。但是由于 JobService 在 Android Framework 中设计的方式,您不能这样做。以下是 jobId 的官方描述:
应用为这个作业提供的 ID。 随后调用取消,或创建相同 jobId 的作业,
将会更新已经存在的同一个 ID 的作业。该 ID 在同一个 uid 的所有客户端(不只是同一个应用包)中必须是唯一的。
您需要确保该 ID 在应用更新时始终保持稳定,因此它可能不应该基于资源 ID。
根据以上的描述,即使您使用 4 个不同的 Java 对象(即 -JobService),也仍然不能使用 channelId 来作为它们的 jobId。类级别的命名空间不能帮助到您。
这确实是个问题。您需要一个稳定、可扩展的方式来将 channelId 和它的 jobId 关联起来。而最糟的结果莫过于,由于 jobId 冲突,导致不同的频道互相覆盖操作。如果jobId 是 String 类型,而不是 Integer 类型的话,解决起来就很容易:ChannelProgramsJobService 的 jobId = "ChannelPrograms" + channelId, ChannelLoggerJobService 的 jobId = "ChannelLogs" + channelId,等等。但因为 jobId 属于 Integer 类型,而不属于 String 类型,所以您就要设计一个智能的系统,用来为您的作业生成可重复使用 jobId。
重点来了 —— 现在我们来聊聊 JobIdManager,看怎样用它来解决这个问题。
JobIdManager 是一个类别,您可以根据自己的应用需求进行调整。对于目前谈到的这个电视应用,基本构想是:使用一个 channelId 处理与 Channel 相关的所有作业 。下面我们先来看看这个样本 JobIdManager 类的代码 ,然后再详细讨论。
public class JobIdManager {
public static final int JOB_TYPE_CHANNEL_PROGRAMS = 1;
public static final int JOB_TYPE_CHANNEL_METADATA = 2;
public static final int JOB_TYPE_CHANNEL_DELETION = 3;
public static final int JOB_TYPE_CHANNEL_LOGGER = 4;
public static final int JOB_TYPE_USER_PREFS = 11;
public static final int JOB_TYPE_USER_BEHAVIOR = 21;
@IntDef(value = {
JOB_TYPE_CHANNEL_PROGRAMS,
JOB_TYPE_CHANNEL_METADATA,
JOB_TYPE_CHANNEL_DELETION,
JOB_TYPE_CHANNEL_LOGGER,
JOB_TYPE_USER_PREFS,
JOB_TYPE_USER_BEHAVIOR })
@Retention(RetentionPolicy.SOURCE)
public @interface JobType {
}
//16-1 for short. Adjust per your needs
private static final int JOB_TYPE_SHIFTS = 15;
public static int getJobId(@JobType int jobType, int objectId) {
if ( 0 < objectId && objectId < (1<< JOB_TYPE_SHIFTS) ) {
return (jobType << JOB_TYPE_SHIFTS) + objectId;
} else {
String err = String.format("objectId %s must be between %s and %s",
objectId,0,(1<<JOB_TYPE_SHIFTS));
throw new IllegalArgumentException(err);
}
}
}
如您所见,JobIdManager 只需结合一个前缀和 channelId 即可获得 jobId。然而这种简单优雅的解决方案只是冰山一角。我们来考虑一下假设条件和注意事项。
您必须能够强制 channelId 成为一个 Short 类型,所以当您将 channelId 与一个前缀结合后,您仍然会得到一个有效的 Java Integer。当然,严格来说,它不一定是 Short。只要您的前缀和 channelId 组合成一个不溢出的 Integer,它就能有效运作。但边际处理在坚实的软件工程中至关重要。所以,除非您真的走投无路,否则就强制为 Short 类型吧。在实践中,为远程服务器上具有较大 ID 的对象执行此操作的一种方法是,在本地数据库或 content provider 中定义一个密钥,并使用该密钥生成您的jobId。
您的整个应用只应该有一个 JobIdManager 类。该类可以为应用的所有作业生成 jobId:无论这些工作是否与频道、用户或者其他任何事情有关。事实上我们的示例 JobIdManager 类指出了这一点:并不是所有 JOB_TYPE 都与 Channel 操作有关。一个作业类型与用户偏好有关,一个与用户行为有关。JobIdManager 通过为每个作业类型分配一个不同的前缀来覆盖以上种类型。
您的应用中的每个 -JobService,都必须拥有唯一和最终的 JOB_TYPE_ 前缀。再强调一次,必须是彻底的一对一关系。