/*

  * Licensed to the Apache Software Foundation (ASF) under one

  * or more contributor license agreements.  See the NOTICE file

  * distributed with this work for additional information

  * regarding copyright ownership.  The ASF licenses this file

  * to you 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 javax.faces.component.visit;

 import java.io.Serializable;

 import java.util.Collection;

 import java.util.Iterator;

 import java.util.Set;

 import javax.faces.FactoryFinder;

 import javax.faces.component.UIComponent;

 import javax.faces.context.FacesContext;

 /**

  * @since 2.0

  */

 public abstract class VisitContext

 {

     public static final Collection<String> ALL_IDS = new AllIdsCollection();

     public static VisitContext createVisitContext(FacesContext context)

     {

         VisitContextFactory factory

                 = (VisitContextFactory) FactoryFinder.getFactory(FactoryFinder.VISIT_CONTEXT_FACTORY);

         return factory.getVisitContext(context, null, null);

     }

     public static VisitContext createVisitContext(FacesContext context, Collection<String> ids, Set<VisitHint> hints)

     {

         VisitContextFactory factory

                 = (VisitContextFactory) FactoryFinder.getFactory(FactoryFinder.VISIT_CONTEXT_FACTORY);

         return factory.getVisitContext(context, ids, hints);

     }

     public abstract FacesContext getFacesContext();

     public abstract Set<VisitHint> getHints();

     public abstract Collection<String> getIdsToVisit();

     public abstract Collection<String> getSubtreeIdsToVisit(UIComponent component);

     public abstract VisitResult invokeVisitCallback(UIComponent component, VisitCallback callback);

     private static class AllIdsCollection implements Collection<String>, Serializable

     {

         public boolean add(String e)

         {

             throw new UnsupportedOperationException();

         }

         public boolean addAll(Collection<? extends String> c)

         {

             throw new UnsupportedOperationException();

         }

         public void clear()

         {

             throw new UnsupportedOperationException();

         }

         public boolean contains(Object o)

         {

             throw new UnsupportedOperationException();

         }

         public boolean containsAll(Collection<?> c)

         {

             throw new UnsupportedOperationException();

         }

         public boolean isEmpty()

         {

             return false;

         }

         public Iterator<String> iterator()

         {

             throw new UnsupportedOperationException();

         }

         public boolean remove(Object o)

         {

             throw new UnsupportedOperationException();

         }

         public boolean removeAll(Collection<?> c)

         {

             throw new UnsupportedOperationException();

         }

         public boolean retainAll(Collection<?> c)

         {

             throw new UnsupportedOperationException();

         }

         public int size()

         {

             throw new UnsupportedOperationException();

         }

         public Object[] toArray()

         {

             throw new UnsupportedOperationException();

         }

         public <T> T[] toArray(T[] a)

         {

             throw new UnsupportedOperationException();

         }

     }

 }