content: /*
   * Copyright (C) 2013 4th Line GmbH, Switzerland
   *
   * The contents of this file are subject to the terms of either the GNU
   * Lesser General Public License Version 2 or later ("LGPL") or the
   * Common Development and Distribution License Version 1 or later
   * ("CDDL") (collectively, the "License"). You may not use this file
   * except in compliance with the License. See LICENSE.txt for more
   * information.
   *
   * This program is distributed in the hope that it will be useful,
   * but WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
   */
  
  package org.fourthline.cling.binding.xml;
  
  import org.fourthline.cling.model.Namespace;
  import org.fourthline.cling.model.ValidationException;
  import org.fourthline.cling.model.meta.Device;
  import org.fourthline.cling.model.profile.RemoteClientInfo;
  import org.w3c.dom.Document;
  
  /**
   * Reads and generates device descriptor XML metadata.
   *
   * @author Christian Bauer
   */
  public interface DeviceDescriptorBinder {
  
      public <T extends Device> T describe(T undescribedDevice, String descriptorXml)
              throws DescriptorBindingException, ValidationException;
  
      public <T extends Device> T describe(T undescribedDevice, Document dom)
              throws DescriptorBindingException, ValidationException;
  
      public String generate(Device device, RemoteClientInfo info, Namespace namespace) throws DescriptorBindingException;
  
      public Document buildDOM(Device device, RemoteClientInfo info, Namespace namespace) throws DescriptorBindingException;
  
  }
  