001/** 002The contents of this file are subject to the Mozilla Public License Version 1.1 003(the "License"); you may not use this file except in compliance with the License. 004You may obtain a copy of the License at http://www.mozilla.org/MPL/ 005Software distributed under the License is distributed on an "AS IS" basis, 006WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the 007specific language governing rights and limitations under the License. 008 009The Original Code is "FileBasedGenerator.java". Description: 010"Replacement for the legagy MessageIDGenerator class" 011 012The Initial Developer of the Original Code is University Health Network. Copyright (C) 0132001. All Rights Reserved. 014 015Contributor(s): ______________________________________. 016 017Alternatively, the contents of this file may be used under the terms of the 018GNU General Public License (the "GPL"), in which case the provisions of the GPL are 019applicable instead of those above. If you wish to allow use of your version of this 020file only under the terms of the GPL and not to allow others to use your version 021of this file under the MPL, indicate your decision by deleting the provisions above 022and replace them with the notice and other provisions required by the GPL License. 023If you do not delete the provisions above, a recipient may use your version of 024this file under either the MPL or the GPL. 025 */ 026package ca.uhn.hl7v2.util.idgenerator; 027 028import java.io.BufferedReader; 029import java.io.File; 030import java.io.FileInputStream; 031import java.io.FileOutputStream; 032import java.io.IOException; 033import java.io.InputStreamReader; 034import java.io.PrintWriter; 035import java.util.concurrent.locks.ReentrantLock; 036 037import org.slf4j.Logger; 038import org.slf4j.LoggerFactory; 039 040import ca.uhn.hl7v2.util.Home; 041 042/** 043 * Replacement for {@link ca.uhn.hl7v2.util.MessageIDGenerator}. You should not use this class 044 * directly, however, but wrap it into a {@link DelegatingHiLoGenerator} generator. Its primary 045 * improvement over {@link ca.uhn.hl7v2.util.MessageIDGenerator} is that you can set path and file 046 * name. 047 * <p> 048 * Reading and writing to the file is thread-safe, however, you should not use the same file from 049 * different Java processes because no read/write locks are being checked. 050 */ 051public class FileBasedGenerator extends InMemoryIDGenerator { 052 053 private static final Logger LOG = LoggerFactory.getLogger(FileBasedGenerator.class.getName()); 054 055 private String directory = Home.getHomeDirectory().getAbsolutePath(); 056 private String fileName = "id_file"; 057 private boolean neverFail = true; 058 private boolean used = false; 059 private boolean minimizeReads = false; 060 private final ReentrantLock lock = new ReentrantLock(); 061 062 public FileBasedGenerator() { 063 this(1L); 064 } 065 066 public FileBasedGenerator(long increment) { 067 super(increment); 068 } 069 070 public String getID() throws IOException { 071 try { 072 lock.lock(); 073 074 // If ID is 0, read initial value from file if possible 075 if (!minimizeReads || !used) { 076 long readInitialValue = readInitialValue(getFilePath()); 077 if (readInitialValue >= 0) { 078 set(readInitialValue); 079 } 080 used = true; 081 } 082 083 String id = super.getID(); 084 // The id held in the file is always <increment> larger so that 085 // the ID is still unique after a restart. 086 writeNextValue(Long.parseLong(id) + getIncrement()); 087 return id; 088 } finally { 089 lock.unlock(); 090 } 091 } 092 093 094 private void writeNextValue(long id) throws IOException { 095 try (PrintWriter pw = new PrintWriter(new FileOutputStream(getFilePath(), false))) { 096 pw.println(id); 097 } catch (IOException e) { 098 if (neverFail) { 099 LOG.warn("Could not write ID to file {}, going to use internal ID generator. {}", 100 getFilePath(), e.getMessage()); 101 return; 102 } 103 throw e; 104 } 105 } 106 107 private long readInitialValue(String path) throws IOException { 108 BufferedReader br = null; 109 String id = null; 110 try { 111 br = new BufferedReader(new InputStreamReader(new FileInputStream(path))); 112 id = br.readLine(); 113 return Long.parseLong(id); 114 } catch (IOException e) { 115 LOG.info("Could not read ID file {} ", path); 116 if (!neverFail) { 117 throw e; 118 } 119 return -1; 120 } catch (NumberFormatException e) { 121 LOG.info("ID {} read from file is not a number", id); 122 return -1; 123 } finally { 124 if (br != null) 125 try { 126 br.close(); 127 } catch (IOException ignored) { 128 } 129 } 130 } 131 132 private String getFilePath() { 133 return new File(directory, fileName).getAbsolutePath(); 134 } 135 136 public void setDirectory(String directory) { 137 try { 138 lock.lock(); 139 this.directory = directory; 140 } finally { 141 lock.unlock(); 142 } 143 } 144 145 public void setFileName(String fileName) { 146 try { 147 lock.lock(); 148 this.fileName = fileName; 149 } finally { 150 lock.unlock(); 151 } 152 } 153 154 /** 155 * If set to <code>true</code> (default is <code>false</code>) the generator 156 * minimizes the number of disk reads by caching the last read value. This means 157 * one less disk read per X number of IDs generated, but also means that multiple 158 * instances of this generator may clobber each other's values. 159 */ 160 public void setMinimizeReads(boolean theMinimizeReads) { 161 minimizeReads = theMinimizeReads; 162 } 163 164 /** 165 * If set to <code>false</code> (default is <code>true</code>), 166 * retrieving a new ID may fail if the ID file in the home 167 * directory can not be written/read. If set to true, failures 168 * will be ignored, which means that IDs may be repeated after 169 * a JVM restart. 170 */ 171 public void setNeverFail(boolean neverFail) { 172 this.neverFail = neverFail; 173 } 174 175 public void reset() { 176 try { 177 lock.lock(); 178 super.reset(); 179 writeNextValue(0L); 180 } catch (IOException e) { 181 throw new IllegalStateException("Cannot initialize persistent ID generator", e); 182 } finally { 183 lock.unlock(); 184 } 185 } 186 187}