source: other-projects/hathitrust/wcsa/extracted-features-solr/trunk/solr-ingest/src/main/java/org/hathitrust/extractedfeatures/ProcessForSolrIngest.java@ 31375

package org.hathitrust.extractedfeatures;

import java.io.BufferedInputStream;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.Serializable;
import java.util.ArrayList;

import org.apache.commons.cli.*;
import org.apache.hadoop.io.Text;
import org.apache.spark.api.java.*;
import org.apache.spark.util.DoubleAccumulator;
import org.apache.spark.util.LongAccumulator;
import org.hathitrust.extractedfeatures.PerPageJSONFlatmap;
import org.json.JSONObject;
import org.apache.spark.SparkConf;

public class ProcessForSolrIngest implements Serializable
{
    private static final long serialVersionUID = 1L;

    protected static final int DEFAULT_NUM_CORES = 10;
    protected static final int MINIMUM_NUM_PARTITIONS = 10*DEFAULT_NUM_CORES; 
    
    protected static final int DEFAULT_FILES_PER_PARTITION = 3000;
    
    protected String _input_dir;
    //protected String _json_list_filename;
    protected String _whitelist_filename;
    protected String _langmap_directory;
    
    protected String _solr_url;
    protected String _output_dir;
    
    protected int    _verbosity;

    public ProcessForSolrIngest(String input_dir, /*String json_list_filename,*/ 
                                String solr_url, String output_dir, int verbosity)
    {
        _input_dir = input_dir;
        //_json_list_filename = (json_list_filename != null) ? json_list_filename : input_dir;

        boolean use_whitelist = Boolean.getBoolean("wcsa-ef-ingest.use-whitelist");
        _whitelist_filename = (use_whitelist) ?  System.getProperty("wcsa-ef-ingest.whitelist-filename") : null;
        
        boolean use_langmap = Boolean.getBoolean("wcsa-ef-ingest.use-langmap");
        _langmap_directory = (use_langmap) ?  System.getProperty("wcsa-ef-ingest.langmap-directory") : null;
        
        
        _solr_url   = solr_url;
        _output_dir = output_dir;
        _verbosity  = verbosity;
    }

    protected String generateSparkAppName(String exec_mode)
    {
        String spark_app_name = "[" + exec_mode + "] Extract Features: Process for Solr Ingest";
        //spark_app_name += " [" + _json_list_filename + "]";

        if (_solr_url != null) { 
            spark_app_name += " solr_url=" + _solr_url;
        }
        
        if (_output_dir != null) { 
            spark_app_name += " output_dir=" + _output_dir;
        }
        
        return spark_app_name;
    }
    
    public ArrayList<String> extrapolateSolrEndpoints()
    {
        ArrayList<String> solr_endpoints = new ArrayList<String>();
        
        if (_solr_url != null) {
            String solr_cloud_nodes = System.getProperty("wcsa-ef-ingest.solr-cloud-nodes",null);
            if (solr_cloud_nodes != null) {
                String [] cloud_nodes = solr_cloud_nodes.split(",");
                for (String cn : cloud_nodes) {
                    String solr_endpoint = _solr_url.replaceFirst("//.*?:\\d+/", "//"+cn+"/");
                    solr_endpoints.add(solr_endpoint);
                }
            }
            else {
                solr_endpoints.add(_solr_url);
            }
        }
        
        return solr_endpoints;
    }
    
    public void execPerVolumeSequenceFile()
    {
        String spark_app_name = generateSparkAppName("Per Volume");     

        SparkConf conf = new SparkConf().setAppName(spark_app_name);
        JavaSparkContext jsc = new JavaSparkContext(conf);
        jsc.hadoopConfiguration().set("io.compression.codec.bzip2.library", "java-builtin");

        //String packed_sequence_path = "hdfs:///user/capitanu/data/packed-ef";
        String packed_sequence_path = _input_dir;
        
        JavaPairRDD<Text, Text> input_pair_rdd = jsc.sequenceFile(packed_sequence_path, Text.class, Text.class);
    
        JavaRDD<Text> json_text_rdd = input_pair_rdd.map(item -> item._2);
        
        boolean icu_tokenize = Boolean.getBoolean("wcsa-ef-ingest.icu-tokenize");
        boolean strict_file_io = Boolean.getBoolean("wcsa-ef-ingest.strict-file-io");
        
        PerVolumeJSON per_vol_json = new PerVolumeJSON(_input_dir,_whitelist_filename, _langmap_directory,
                                                       _solr_url,_output_dir,_verbosity,
                                                       icu_tokenize,strict_file_io);

        
        JavaRDD<Integer> per_volume_page_count = json_text_rdd.map(per_vol_json);
        
        Integer num_page_ids = per_volume_page_count.reduce((a, b) -> a + b);
        
        System.out.println("");
        System.out.println("############");
        System.out.println("# Number of page ids: " + num_page_ids);
        System.out.println("############");
        System.out.println("");

        jsc.close();
        
    }
    
    /*
    public void execPerVolume()
    {   
        String spark_app_name = generateSparkAppName("Per Volume");     
        
        SparkConf conf = new SparkConf().setAppName(spark_app_name);
        JavaSparkContext jsc = new JavaSparkContext(conf);
            
        //int num_partitions = Integer.getInteger("wcsa-ef-ingest.num-partitions", DEFAULT_NUM_PARTITIONS);
        int files_per_partition = Integer.getInteger("wcsa-ef-ingest.files-per-partition", DEFAULT_FILES_PER_PARTITION);
        
        JavaRDD<String> json_list_data = jsc.textFile(_json_list_filename).cache();

        long num_volumes = json_list_data.count();
        double per_vol = 100.0/(double)num_volumes;
        
        int num_partitions = (int)(num_volumes/files_per_partition)+1;
        if (num_partitions < MINIMUM_NUM_PARTITIONS) {
            num_partitions = MINIMUM_NUM_PARTITIONS;
        }
        JavaRDD<String> json_list_data_rp = json_list_data.repartition(num_partitions);

        DoubleAccumulator progress_accum = jsc.sc().doubleAccumulator("Progress Percent");
        
        boolean icu_tokenize = Boolean.getBoolean("wcsa-ef-ingest.icu-tokenize");
        boolean strict_file_io = Boolean.getBoolean("wcsa-ef-ingest.strict-file-io");
        
        PerVolumeJSON per_vol_json = new PerVolumeJSON(_input_dir,_whitelist_filename, 
                                                       _solr_url,_output_dir,_verbosity, progress_accum,per_vol,
                                                       icu_tokenize,strict_file_io);

        //json_list_data_rp.foreach(per_vol_json);
        JavaRDD<String> per_page_ids = json_list_data_rp.flatMap(per_vol_json);
        long num_page_ids = per_page_ids.count(); // trigger lazy eval of: flatmap:per-vol 
        
        //long num_ids = num_volumes;
        
        System.out.println("");
        System.out.println("############");
        System.out.println("# Number of page ids: " + num_page_ids);
        System.out.println("############");
        System.out.println("");

        jsc.close();
    }
    */
    
    /*
    public void execPerPage()
    {   
        String spark_app_name = generateSparkAppName("Per Page");       
        
        SparkConf conf = new SparkConf().setAppName(spark_app_name);
        JavaSparkContext jsc = new JavaSparkContext(conf);
        
        
        
        //int num_partitions = Integer.getInteger("wcsa-ef-ingest.num-partitions", DEFAULT_NUM_PARTITIONS);
        int files_per_partition = Integer.getInteger("wcsa-ef-ingest.num-partitions", DEFAULT_FILES_PER_PARTITION);
        
        JavaRDD<String> json_list_data = jsc.textFile(_json_list_filename).cache();

        long num_volumes = json_list_data.count();
        double per_vol = 100.0/(double)num_volumes;
        
        int num_partitions = (int)(num_volumes/files_per_partition)+1;
        JavaRDD<String> json_list_data_rp = json_list_data.repartition(num_partitions);

        DoubleAccumulator per_vol_progress_accum = jsc.sc().doubleAccumulator("Per Volume Progress Percent");
        
        boolean icu_tokenize = Boolean.getBoolean("wcsa-ef-ingest.icu-tokenize");
        boolean strict_file_io = Boolean.getBoolean("wcsa-ef-ingest.strict-file-io");
        
        PerPageJSONFlatmap paged_solr_json_flatmap 
            = new PerPageJSONFlatmap(_input_dir,_whitelist_filename,
                                     _solr_url,_output_dir,_verbosity, 
                                     per_vol_progress_accum,per_vol,
                                     icu_tokenize,strict_file_io);
        //JavaRDD<JSONObject> per_page_jsonobjects = json_list_data_rp.flatMap(paged_solr_json_flatmap).cache();
        JavaRDD<JSONObject> per_page_jsonobjects = json_list_data_rp.flatMap(paged_solr_json_flatmap);
        
        //long num_page_ids = per_page_jsonobjects.count(); // trigger lazy eval of: flatmap:per-vol

        LongAccumulator per_page_progress_accum = jsc.sc().longAccumulator("Pages Processed");
        ArrayList<String> solr_endpoints = extrapolateSolrEndpoints();
        
        
        PerPageJSONMap paged_json_id_map 
            = new PerPageJSONMap(_input_dir,solr_endpoints,_output_dir,_verbosity, 
                                 per_page_progress_accum,1);
        JavaRDD<String> per_page_ids = per_page_jsonobjects.map(paged_json_id_map);

        
        long num_page_ids = per_page_ids.count(); // trigger lazy eval of: flatmap:per-vol -> map:per-page
        
        System.out.println("");
        System.out.println("############");
        System.out.println("# Number of page ids: " + num_page_ids);
        System.out.println("############");
        System.out.println("");

        
        //if (_output_dir != null) {
            //String rdd_save_file = "rdd-solr-json-page-files";
            //json_ids.saveAsTextFile(rdd_save_file);
            //System.out.println("############");
            //System.out.println("# Saved RDD of Solr JSON page files, top-level, as:");
            //System.out.println("#  " + rdd_save_file);
            //System.out.println("############");
            //System.out.println("");
        //}
        
        
        jsc.close();
    }
*/
    
    

    public static void print_usage(HelpFormatter formatter, Options options)
    {
        formatter.printHelp("RUN.bash [options] input-dir json-filelist.txt", options);
    }
    
    public static void main(String[] args) {
        Options options = new Options();

        Option verbosity_opt = new Option("v", "verbosity", true, 
                "Set to control the level of debugging output [0=none, 1=some, 2=lots]");
        verbosity_opt.setRequired(false);
        options.addOption(verbosity_opt);
        
        Option properties_opt = new Option("p", "properties", true, 
                "Read in the specified Java properties file");
        properties_opt.setRequired(false);
        options.addOption(properties_opt);
        
        Option output_dir_opt = new Option("o", "output-dir", true, 
                "If specified, save BZipped Solr JSON files to this directory");
        output_dir_opt.setRequired(false);
        options.addOption(output_dir_opt);
        
        Option solr_url_opt = new Option("u", "solr-url", true, 
                "If specified, the URL to post the Solr JSON data to");
        solr_url_opt.setRequired(false);
        options.addOption(solr_url_opt);
        
        Option read_only_opt = new Option("r", "read-only", false, 
                "Used to initiate a run where the files are all read in, but nothing is ingested/saved");
        read_only_opt.setRequired(false);
        options.addOption(read_only_opt);
        
        // Need to work with CLI v1.2 as this is the JAR that is bundled with Hadoop/Spark 
        CommandLineParser parser = new GnuParser(); 
        //CommandLineParser parser = new DefaultParser(); // if working with CLI v1.3 and above
        
        HelpFormatter formatter = new HelpFormatter();
        CommandLine cmd = null;

        try {
            cmd = parser.parse(options, args);
        }
        catch (ParseException e) {
            System.err.println(e.getMessage());
            print_usage(formatter,options);
            System.exit(1);
        }

        
        String verbosity_str = cmd.getOptionValue("verbosity","1");
        int verbosity = Integer.parseInt(verbosity_str);

        String property_filename = cmd.getOptionValue("properties",null);
    
        String output_dir = cmd.getOptionValue("output-dir",null);
        String solr_url   = cmd.getOptionValue("solr-url",null);
        boolean read_only   = cmd.hasOption("read-only");
        
        String[] filtered_args = cmd.getArgs();

        if (filtered_args.length != 1) {
            print_usage(formatter,options);
            System.exit(1);
        }
    
        if (property_filename != null) {
            try {
                FileInputStream fis = new FileInputStream(property_filename);
                BufferedInputStream bis = new BufferedInputStream(fis);
                
                System.getProperties().load(bis);
            } 
            catch (FileNotFoundException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
                System.err.println("File not found: '" + property_filename + "'. Skipping property file read");
            }
            catch (IOException e) {
                System.err.println("IO Exception for: '" + property_filename + "'. Malformed syntax? Skipping property file read");
            }
        }
        
        if (!read_only && ((output_dir == null) && (solr_url==null))) {
            System.err.println("Need to specify either --solr-url or --output-dir otherwise generated files are not ingested/saved");
            print_usage(formatter,options);
            System.exit(1);
        }
        if (read_only) {
            // For this case, need to ensure solr-url and output-dir are null
            output_dir = null;
            solr_url = null;
        }
        
        String input_dir  = filtered_args[0];
        //String json_list_filename = filtered_args[1];
        
        ProcessForSolrIngest prep_for_ingest 
            = new ProcessForSolrIngest(input_dir,/*json_list_filename,*/solr_url,output_dir,verbosity);
            
        prep_for_ingest.execPerVolumeSequenceFile();
        
        /*
        String process_ef_json_mode = System.getProperty("wcsa-ef-ingest.process-ef-json-mode","per-page");
        if (process_ef_json_mode.equals("per-volume")) { 
            prep_for_ingest.execPerVolume();
        }
        else {
            prep_for_ingest.execPerPage();
        }*/
    }
}