Clover icon

jalviewX

  1. Project Clover database Wed Oct 31 2018 15:13:58 GMT
  2. Package org.stackoverflowusers.file

File WindowsShortcut.java

 

Coverage histogram

../../../img/srcFileCovDistChart0.png
56% of files have more coverage

Code metrics

16
71
12
1
215
127
22
0.31
5.92
12
1.83

Classes

Class Line # Actions
WindowsShortcut 27 71 22 99
0.00%
 

Contributing tests

No tests hitting this source file were found.

Source view

1    package org.stackoverflowusers.file;
2   
3    import java.io.ByteArrayOutputStream;
4    import java.io.File;
5    import java.io.FileInputStream;
6    import java.io.IOException;
7    import java.io.InputStream;
8    import java.text.ParseException;
9   
10    /**
11    * Represents a Windows shortcut (typically visible to Java only as a '.lnk' file).
12    *
13    * Retrieved 2011-09-23 from http://stackoverflow.com/questions/309495/windows-shortcut-lnk-parser-in-java/672775#672775
14    * Originally called LnkParser
15    *
16    * Written by: (the stack overflow users, obviously!)
17    * Apache Commons VFS dependency removed by crysxd (why were we using that!?) https://github.com/crysxd
18    * Headerified, refactored and commented by Code Bling http://stackoverflow.com/users/675721/code-bling
19    * Network file support added by Stefan Cordes http://stackoverflow.com/users/81330/stefan-cordes
20    * Adapted by Sam Brightman http://stackoverflow.com/users/2492/sam-brightman
21    * Based on information in 'The Windows Shortcut File Format' by Jesse Hager <jessehager@iname.com>
22    * And somewhat based on code from the book 'Swing Hacks: Tips and Tools for Killer GUIs'
23    * by Joshua Marinacci and Chris Adamson
24    * ISBN: 0-596-00907-0
25    * http://www.oreilly.com/catalog/swinghks/
26    */
 
27    public class WindowsShortcut
28    {
29    private boolean isDirectory;
30    private boolean isLocal;
31    private String real_file;
32   
33    /**
34    * Provides a quick test to see if this could be a valid link !
35    * If you try to instantiate a new WindowShortcut and the link is not valid,
36    * Exceptions may be thrown and Exceptions are extremely slow to generate,
37    * therefore any code needing to loop through several files should first check this.
38    *
39    * @param file the potential link
40    * @return true if may be a link, false otherwise
41    * @throws IOException if an IOException is thrown while reading from the file
42    */
 
43  0 toggle public static boolean isPotentialValidLink(File file) throws IOException {
44  0 final int minimum_length = 0x64;
45  0 InputStream fis = new FileInputStream(file);
46  0 boolean isPotentiallyValid = false;
47  0 try {
48  0 isPotentiallyValid = file.isFile()
49    && file.getName().toLowerCase().endsWith(".lnk")
50    && fis.available() >= minimum_length
51    && isMagicPresent(getBytes(fis, 32));
52    } finally {
53  0 fis.close();
54    }
55  0 return isPotentiallyValid;
56    }
57   
 
58  0 toggle public WindowsShortcut(File file) throws IOException, ParseException {
59  0 InputStream in = new FileInputStream(file);
60  0 try {
61  0 parseLink(getBytes(in));
62    } finally {
63  0 in.close();
64    }
65    }
66   
67    /**
68    * @return the name of the filesystem object pointed to by this shortcut
69    */
 
70  0 toggle public String getRealFilename() {
71  0 return real_file;
72    }
73   
74    /**
75    * Tests if the shortcut points to a local resource.
76    * @return true if the 'local' bit is set in this shortcut, false otherwise
77    */
 
78  0 toggle public boolean isLocal() {
79  0 return isLocal;
80    }
81   
82    /**
83    * Tests if the shortcut points to a directory.
84    * @return true if the 'directory' bit is set in this shortcut, false otherwise
85    */
 
86  0 toggle public boolean isDirectory() {
87  0 return isDirectory;
88    }
89   
90    /**
91    * Gets all the bytes from an InputStream
92    * @param in the InputStream from which to read bytes
93    * @return array of all the bytes contained in 'in'
94    * @throws IOException if an IOException is encountered while reading the data from the InputStream
95    */
 
96  0 toggle private static byte[] getBytes(InputStream in) throws IOException {
97  0 return getBytes(in, null);
98    }
99   
100    /**
101    * Gets up to max bytes from an InputStream
102    * @param in the InputStream from which to read bytes
103    * @param max maximum number of bytes to read
104    * @return array of all the bytes contained in 'in'
105    * @throws IOException if an IOException is encountered while reading the data from the InputStream
106    */
 
107  0 toggle private static byte[] getBytes(InputStream in, Integer max) throws IOException {
108    // read the entire file into a byte buffer
109  0 ByteArrayOutputStream bout = new ByteArrayOutputStream();
110  0 byte[] buff = new byte[256];
111  0 while (max == null || max > 0) {
112  0 int n = in.read(buff);
113  0 if (n == -1) {
114  0 break;
115    }
116  0 bout.write(buff, 0, n);
117  0 if (max != null)
118  0 max -= n;
119    }
120  0 in.close();
121  0 return bout.toByteArray();
122    }
123   
 
124  0 toggle private static boolean isMagicPresent(byte[] link) {
125  0 final int magic = 0x0000004C;
126  0 final int magic_offset = 0x00;
127  0 return link.length >= 32 && bytesToDword(link, magic_offset) == magic;
128    }
129   
130    /**
131    * Gobbles up link data by parsing it and storing info in member fields
132    * @param link all the bytes from the .lnk file
133    */
 
134  0 toggle private void parseLink(byte[] link) throws ParseException {
135  0 try {
136  0 if (!isMagicPresent(link))
137  0 throw new ParseException("Invalid shortcut; magic is missing", 0);
138   
139    // get the flags byte
140  0 byte flags = link[0x14];
141   
142    // get the file attributes byte
143  0 final int file_atts_offset = 0x18;
144  0 byte file_atts = link[file_atts_offset];
145  0 byte is_dir_mask = (byte)0x10;
146  0 if ((file_atts & is_dir_mask) > 0) {
147  0 isDirectory = true;
148    } else {
149  0 isDirectory = false;
150    }
151   
152    // if the shell settings are present, skip them
153  0 final int shell_offset = 0x4c;
154  0 final byte has_shell_mask = (byte)0x01;
155  0 int shell_len = 0;
156  0 if ((flags & has_shell_mask) > 0) {
157    // the plus 2 accounts for the length marker itself
158  0 shell_len = bytesToWord(link, shell_offset) + 2;
159    }
160   
161    // get to the file settings
162  0 int file_start = 0x4c + shell_len;
163   
164  0 final int file_location_info_flag_offset_offset = 0x08;
165  0 int file_location_info_flag = link[file_start + file_location_info_flag_offset_offset];
166  0 isLocal = (file_location_info_flag & 2) == 0;
167    // get the local volume and local system values
168    //final int localVolumeTable_offset_offset = 0x0C;
169  0 final int basename_offset_offset = 0x10;
170  0 final int networkVolumeTable_offset_offset = 0x14;
171  0 final int finalname_offset_offset = 0x18;
172  0 int finalname_offset = link[file_start + finalname_offset_offset] + file_start;
173  0 String finalname = getNullDelimitedString(link, finalname_offset);
174  0 if (isLocal) {
175  0 int basename_offset = link[file_start + basename_offset_offset] + file_start;
176  0 String basename = getNullDelimitedString(link, basename_offset);
177  0 real_file = basename + finalname;
178    } else {
179  0 int networkVolumeTable_offset = link[file_start + networkVolumeTable_offset_offset] + file_start;
180  0 int shareName_offset_offset = 0x08;
181  0 int shareName_offset = link[networkVolumeTable_offset + shareName_offset_offset]
182    + networkVolumeTable_offset;
183  0 String shareName = getNullDelimitedString(link, shareName_offset);
184  0 real_file = shareName + "\\" + finalname;
185    }
186    } catch (ArrayIndexOutOfBoundsException e) {
187  0 throw new ParseException("Could not be parsed, probably not a valid WindowsShortcut", 0);
188    }
189    }
190   
 
191  0 toggle private static String getNullDelimitedString(byte[] bytes, int off) {
192  0 int len = 0;
193    // count bytes until the null character (0)
194  0 while (true) {
195  0 if (bytes[off + len] == 0) {
196  0 break;
197    }
198  0 len++;
199    }
200  0 return new String(bytes, off, len);
201    }
202   
203    /*
204    * convert two bytes into a short note, this is little endian because it's
205    * for an Intel only OS.
206    */
 
207  0 toggle private static int bytesToWord(byte[] bytes, int off) {
208  0 return ((bytes[off + 1] & 0xff) << 8) | (bytes[off] & 0xff);
209    }
210   
 
211  0 toggle private static int bytesToDword(byte[] bytes, int off) {
212  0 return (bytesToWord(bytes, off + 2) << 16) | bytesToWord(bytes, off);
213    }
214   
215    }