001    /*
002     * Created on Dec 26, 2009
003     *
004     * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
005     * in compliance with the License. You may obtain a copy of the License at
006     *
007     * http://www.apache.org/licenses/LICENSE-2.0
008     *
009     * Unless required by applicable law or agreed to in writing, software distributed under the License
010     * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
011     * or implied. See the License for the specific language governing permissions and limitations under
012     * the License.
013     *
014     * Copyright @2009-2010 the original author or authors.
015     */
016    package org.fest.swing.fixture;
017    
018    import javax.swing.JTree;
019    
020    import org.fest.swing.exception.ActionFailedException;
021    
022    /**
023     * Understands functional testing of single nodes in <code>{@link JTree}</code>s:
024     * <ul>
025     * <li>user input simulation</li>
026     * <li>state verification</li>
027     * <li>property value query</li>
028     * </ul>
029     *
030     * @author Alex Ruiz
031     *
032     * @since 1.2
033     */
034    public interface JTreeNodeFixture extends ItemFixture {
035    
036      /**
037       * Simulates a user expanding this fixture's tree node.
038       * @return this fixture.
039       * @throws IllegalStateException if the <code>JTree</code> is disabled.
040       * @throws IllegalStateException if the <code>JTree</code> is not showing on the screen.
041       * @throws ActionFailedException if this method fails to expand the row.
042       */
043      JTreeNodeFixture expand();
044    
045      /**
046       * Simulates a user collapsing this fixture's tree node.
047       * @return this fixture.
048       * @throws IllegalStateException if the <code>JTree</code> is disabled.
049       * @throws IllegalStateException if the <code>JTree</code> is not showing on the screen.
050       * @throws ActionFailedException if this method fails to collapse the row.
051       */
052      JTreeNodeFixture collapse();
053    }