/**
   * Given a {@link ChangePackageEnvelope} which contains a change package fragment, stores one or
   * more fragments by attaching them to a session specific adapter.
   *
   * @param sessionId the {@link SessionId} belonging to the calling user
   * @param projectId the {@link ProjectId}
   * @param envelope the {@link ChangePackageEnvelope} containing the fragment
   * @return an ID identifying the stored fragment(s)
   * @throws ESException in case the fragment couldn't be stored
   */
  @ESMethod(MethodId.UPLOADCHANGEPACKAGEFRAGMENT)
  public String uploadChangePackageFragment(
      SessionId sessionId, ProjectId projectId, ChangePackageEnvelope envelope) throws ESException {

    final String proxyId = generateProxyId(projectId.getId());

    final ESSessionId resolvedSession =
        getAccessControl().getSessions().resolveSessionById(sessionId.getId());

    if (resolvedSession == null) {
      throw new ESException(
          MessageFormat.format(Messages.VersionSubInterfaceImpl_0, sessionId.getId()));
    }

    final SessionId session = APIUtil.toInternal(SessionId.class, resolvedSession);
    final Optional<ChangePackageFragmentUploadAdapter> maybeAdapter =
        ESCollections.find(session.eAdapters(), ChangePackageFragmentUploadAdapter.class);
    ChangePackageFragmentUploadAdapter adapter;

    if (!maybeAdapter.isPresent()) {
      adapter = new ChangePackageFragmentUploadAdapter();
      session.eAdapters().add(adapter);
    } else {
      adapter = maybeAdapter.get();
    }

    adapter.addFragment(proxyId, envelope.getFragment());
    if (envelope.isLast()) {
      adapter.markAsComplete(proxyId);
    }

    return proxyId;
  }
  /**
   * Fetches a single change package fragment.
   *
   * @param sessionId the {@link SessionId} representing the requesting user
   * @param proxyId the ID that identifies the list of stored fragments
   * @param fragmentIndex allows to request different change package fragments
   * @return a {@link ChangePackageEnvelope} containing the change package fragment
   * @throws ESException in case the mandatory session adapter is missing
   */
  @ESMethod(MethodId.DOWNLOADCHANGEPACKAGEFRAGMENT)
  public ChangePackageEnvelope downloadChangePackageFragment(
      SessionId sessionId, String proxyId, int fragmentIndex) throws ESException {

    final ESSessionId resolvedSession =
        getAccessControl().getSessions().resolveSessionById(sessionId.getId());
    final SessionId session = APIUtil.toInternal(SessionId.class, resolvedSession);
    final Optional<ChangePackageFragmentProviderAdapter> maybeAdapter =
        ESCollections.find(session.eAdapters(), ChangePackageFragmentProviderAdapter.class);

    if (!maybeAdapter.isPresent()) {
      throw new ESException(
          Messages.VersionSubInterfaceImpl_ChangePackageFragmentProviderAdapterMissing + sessionId);
    }

    final ChangePackageFragmentProviderAdapter adapter = maybeAdapter.get();
    final ChangePackageEnvelope envelope =
        VersioningFactory.eINSTANCE.createChangePackageEnvelope();
    final List<String> fragment = adapter.getFragment(proxyId, fragmentIndex);

    envelope.getFragment().addAll(fragment);
    envelope.setFragmentCount(adapter.getFragmentSize(proxyId));
    envelope.setFragmentIndex(fragmentIndex);

    if (envelope.isLast()) {
      adapter.markAsConsumed(proxyId);
    }

    return envelope;
  }