elemental.html.File Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of gwt-elemental Show documentation

There is a newer version: 2.8.2.vaadin2

/*
 * Copyright 2012 Google Inc.
 * 
 * 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 elemental.html;

import elemental.events.*;
import elemental.util.*;
import elemental.dom.*;
import elemental.html.*;
import elemental.css.*;
import elemental.stylesheets.*;

import java.util.Date;

/**
  * The File object provides information about -- and access to the contents of -- files. These are generally retrieved from a FileList
 object returned as a result of a user selecting files using the input element, or from a drag and drop operation's DataTransfer object.


Gecko 2.0 note(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)


Starting in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)
, the File object inherits from the Blob
 interface, which provides methods and properties providing further information about the file.

The file reference can be saved when the form is submitted while the user is offline, so that the data can be retrieved and uploaded when the Internet connection is restored.
Note: The File object as implemented by Gecko offers several non-standard methods for reading the contents of the file. These should not be used, as they will prevent your web application from being used in other browsers, as well as in future versions of Gecko, which will likely remove these methods.
  */
public interface File extends Blob {

  Date getLastModifiedDate();


  /**
    * The name of the file referenced by the File object. Read only. 
Requires Gecko 1.9.2
    */
  String getName();

  String getWebkitRelativePath();
}