1 // Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).

     2 // All rights reserved.

     3 // This component and the accompanying materials are made available

     4 // under the terms of "Eclipse Public License v1.0"

     5 // which accompanies this distribution, and is available

     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

     7 //

     8 // Initial Contributors:

     9 // Nokia Corporation - initial contribution.

    10 //

    11 // Contributors:

    12 //

    13 // Description:

    14 // IFileInputValidator

    15 //

    16 

    17 

    18 

    19 package com.symbian.smt.gui.smtwidgets;

    20 

    21 import org.eclipse.jface.dialogs.IInputValidator;

    22 

    23 /**

    24  * This is an extension of the IInputValidator interface which caters for

    25  * validation of local files and URLs.

    26  * <p>

    27  * While isValid() is invoked dynamically as the user types his input (as per

    28  * the standard IInputValidator interface), the methods

    29  * <code>isFileReadable()</code> and <code>isUrlResourceReadable</code> defined

    30  * by this interface are invoked when the user presses the dialog's OK button,

    31  * as these operations may take longer to execute.

    32  * <p>

    33  * The third method, <code>isUrl()</code>, is a utility method that determines

    34  * whether a given String is a URL or a simple file path.

    35  * 

    36  * @author barbararosi-schwartz

    37  * 

    38  */

    39 public interface IFileInputValidator extends IInputValidator {

    40 	

    41 	// The unconventional method signature follows the pattern of 

    42 	// IInputValidator's isValid() method.

    43 	public String isFileReadable(String filePath);

    44 

    45 	// The unconventional method signature follows the pattern of 

    46 	// IInputValidator's isValid() method.

    47 	public boolean isUrl(String filePath) throws InvalidPathException;

    48 

    49 	// The unconventional method signature follows the pattern of 

    50 	// IInputValidator's isValid() method.

    51 	public String isUrlResourceReadable(String urlPath);

    52 }