Package edu.suffolk.litlab.efsp.ecfcodes

Class CodeUpdater

java.lang.Object

edu.suffolk.litlab.efsp.ecfcodes.CodeUpdater

public class CodeUpdater
extends Object

Updates the Tyler "Codes" for each court in a jurisdiction.

There are 3 main steps to download a code for a Tyler court: 1. calling `FilingReview::getPolicy` for a court to get the URLs that the codes are available at. - this URL can change, but tbh doesn't change often. It takes approximately 1 for a call to getPolicy to complete. 2. downloading the codes, which are zip files available at the above URL. - You need the court itself, the table that you are downloading. Currently, we take the input stream and divert it directly to the XMLStream reader, so we don't need to write out to a file. 3. updating the Postgres codes database - this takes the XMLStreamReader, unmarshalls it into a java object, and uses that to populate the code database. Most code for that is in tyler.CodeDatabase.

We parallelize this as much as possible, which means steps 1 and 2 are done in batch, and each court / court-table item is done in parallel. Step 3, however, can't seem to be parallelized, due to java issues. See https://github.com/SuffolkLITLab/EfileProxyServer/issues/111

For TX, IL, and MA, it takes ~45 minutes to refresh all of the codes.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	CodeUpdater.CourtCodelistInfo

Constructor Summary

Constructors

Constructor	Description
CodeUpdater()

Method Summary

Modifier and Type	Method	Description
boolean	downloadIndiv(List<String> args, BiFunction<String,String,String> makeUrl, CodeUrlGetter urlGetter)	Downloads a single codes zip.
static CodeDatabaseAPI	makeCodeDatabase(Function<DataSource,CodeDatabaseAPI> dbMaker)	Should just be called from main.
boolean	replaceAll(Map<String,String> systemUrls, Function<String,List<CodeUpdater.CourtCodelistInfo>> codeInfoGetter, CodeUrlGetter urlGetter, CodeDatabaseAPI cd)	Downloads all of the codes from scratch, deleting all of the existing info already in tables.
boolean	replaceSome(Map<String,String> systemUrls, Function<String,List<CodeUpdater.CourtCodelistInfo>> codeInfoGetter, CodeUrlGetter urlGetter, CodeDatabaseAPI cd, List<String> locs)
boolean	updateAll(Map<String,String> systemUrls, Function<String,List<CodeUpdater.CourtCodelistInfo>> codeInfoGetter, CodeUrlGetter urlGetter, CodeDatabaseAPI cd)	Returns true if successful, false if not successful

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CodeUpdater

public CodeUpdater()

Method Details

updateAll

public boolean updateAll(Map<String,String> systemUrls,
 Function<String,List<CodeUpdater.CourtCodelistInfo>> codeInfoGetter,
 CodeUrlGetter urlGetter,
 CodeDatabaseAPI cd)
                  throws SQLException,
IOException,
jakarta.xml.bind.JAXBException,
URISyntaxException

Returns true if successful, false if not successful

Throws:

URISyntaxException

SQLException

IOException

jakarta.xml.bind.JAXBException

replaceAll

public boolean replaceAll(Map<String,String> systemUrls,
 Function<String,List<CodeUpdater.CourtCodelistInfo>> codeInfoGetter,
 CodeUrlGetter urlGetter,
 CodeDatabaseAPI cd)
                   throws SQLException,
IOException,
jakarta.xml.bind.JAXBException,
URISyntaxException

Downloads all of the codes from scratch, deleting all of the existing info already in tables.

Throws:

URISyntaxException

SQLException

IOException

jakarta.xml.bind.JAXBException

replaceSome

public boolean replaceSome(Map<String,String> systemUrls,
 Function<String,List<CodeUpdater.CourtCodelistInfo>> codeInfoGetter,
 CodeUrlGetter urlGetter,
 CodeDatabaseAPI cd,
 List<String> locs)
                    throws SQLException,
IOException,
jakarta.xml.bind.JAXBException,
URISyntaxException

Throws:

SQLException

IOException

jakarta.xml.bind.JAXBException

URISyntaxException

downloadIndiv

public boolean downloadIndiv(List<String> args,
 BiFunction<String,String,String> makeUrl,
 CodeUrlGetter urlGetter)
                      throws URISyntaxException

Downloads a single codes zip. For Debugging.

Throws:

URISyntaxException

makeCodeDatabase

public static CodeDatabaseAPI makeCodeDatabase(Function<DataSource,CodeDatabaseAPI> dbMaker)

Should just be called from main.