// Copyright 2016 The Domain Registry Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package google.registry.flows;

import static google.registry.flows.ResourceFlowUtils.verifyAuthInfoForResource;

import google.registry.flows.EppException.ObjectDoesNotExistException;
import google.registry.model.EppResource;
import google.registry.model.eppinput.ResourceCommand.SingleResourceCommand;
import google.registry.util.TypeUtils.TypeInstantiator;

/**
 * An EPP flow that queries a storable resource.
 *
 * @param <R> the resource type being queried
 * @param <C> the command type, marshalled directly from the epp xml
 */
public abstract class ResourceQueryFlow<R extends EppResource, C extends SingleResourceCommand>
    extends SingleResourceFlow<R, C> {
  /** Fail if the object doesn't exist or was deleted. */
  @Override
  protected final void verifyIsAllowed() throws EppException {
    if (existingResource == null) {
      throw new ResourceToQueryDoesNotExistException(
          new TypeInstantiator<R>(getClass()){}.getExactType(), targetId);
    }
    if (command.getAuthInfo() != null) {
      verifyAuthInfoForResource(command.getAuthInfo(), existingResource);
    }
    verifyQueryIsAllowed();
  }

  /** Check command- and resource-specific invariants before allowing the query to proceed. */
  @SuppressWarnings("unused")
  protected void verifyQueryIsAllowed() throws EppException {}

  /** Resource with this id does not exist. */
  public static class ResourceToQueryDoesNotExistException extends ObjectDoesNotExistException {
    public ResourceToQueryDoesNotExistException(Class<?> type, String targetId) {
      super(type, targetId);
    }
  }
}