public synchronized void request(IJob job) { job.ensureReadyToRun(); // append the job to the list of ones to process later on int size = this.awaitingJobs.length; if (++this.jobEnd == size) { // when growing, relocate jobs starting at position 0 this.jobEnd -= this.jobStart; // jobEnd now equals the number of jobs if (this.jobEnd < 50 && this.jobEnd < this.jobStart) { // plenty of free space in the queue so shift the remaining jobs to the beginning instead of // growing it System.arraycopy(this.awaitingJobs, this.jobStart, this.awaitingJobs, 0, this.jobEnd); for (int i = this.jobStart; i < size; i++) this.awaitingJobs[i] = null; } else { System.arraycopy( this.awaitingJobs, this.jobStart, this.awaitingJobs = new IJob[size * 2], 0, this.jobEnd); } this.jobStart = 0; } this.awaitingJobs[this.jobEnd] = job; if (VERBOSE) { Util.verbose("REQUEST background job - " + job); // $NON-NLS-1$ Util.verbose("AWAITING JOBS count: " + awaitingJobsCount()); // $NON-NLS-1$ } notifyAll(); // wake up the background thread if it is waiting }
/** * This API is allowing to run one job in concurrence with background processing. Indeed since * other jobs are performed in background, resource sharing might be an issue.Therefore, this * functionality allows a given job to be run without colliding with background ones. Note: * multiple thread might attempt to perform concurrent jobs at the same time, and should * synchronize (it is deliberately left to clients to decide whether concurrent jobs might * interfere or not. In general, multiple read jobs are ok). * * <p>Waiting policy can be: IJobConstants.ForceImmediateSearch * IJobConstants.CancelIfNotReadyToSearch IJobConstants.WaitUntilReadyToSearch */ public boolean performConcurrentJob( IJob searchJob, int waitingPolicy, IProgressMonitor progress) { if (VERBOSE) Util.verbose("STARTING concurrent job - " + searchJob); // $NON-NLS-1$ searchJob.ensureReadyToRun(); boolean status = IJob.FAILED; try { int concurrentJobWork = 100; if (progress != null) progress.beginTask("", concurrentJobWork); // $NON-NLS-1$ if (awaitingJobsCount() > 0) { switch (waitingPolicy) { case IJob.ForceImmediate: if (VERBOSE) Util.verbose("-> NOT READY - forcing immediate - " + searchJob); // $NON-NLS-1$ try { disable(); // pause indexing status = searchJob.execute( progress == null ? null : new SubProgressMonitor(progress, concurrentJobWork)); } finally { enable(); } if (VERBOSE) Util.verbose("FINISHED concurrent job - " + searchJob); // $NON-NLS-1$ return status; case IJob.CancelIfNotReady: if (VERBOSE) Util.verbose("-> NOT READY - cancelling - " + searchJob); // $NON-NLS-1$ if (VERBOSE) Util.verbose("CANCELED concurrent job - " + searchJob); // $NON-NLS-1$ throw new OperationCanceledException(); case IJob.WaitUntilReady: IProgressMonitor subProgress = null; try { int totalWork = 1000; if (progress != null) { subProgress = new SubProgressMonitor(progress, concurrentJobWork * 8 / 10); subProgress.beginTask("", totalWork); // $NON-NLS-1$ concurrentJobWork = concurrentJobWork * 2 / 10; } // use local variable to avoid potential NPE (see bug 20435 NPE when searching java // method // and bug 42760 NullPointerException in JobManager when searching) Thread t = this.processingThread; int originalPriority = t == null ? -1 : t.getPriority(); try { if (t != null) t.setPriority(Thread.currentThread().getPriority()); synchronized (this) { this.awaitingClients++; } IJob previousJob = null; int awaitingJobsCount; int lastJobsCount = totalWork; float lastWorked = 0; float totalWorked = 0; while ((awaitingJobsCount = awaitingJobsCount()) > 0) { if ((subProgress != null && subProgress.isCanceled()) || this.processingThread == null) throw new OperationCanceledException(); IJob currentJob = currentJob(); // currentJob can be null when jobs have been added to the queue but job manager // is not enabled if (currentJob != null && currentJob != previousJob) { if (VERBOSE) Util.verbose( "-> NOT READY - waiting until ready - " + searchJob); // $NON-NLS-1$ if (subProgress != null) { String indexing = Messages.bind( Messages.jobmanager_filesToIndex, currentJob.getJobFamily(), Integer.toString(awaitingJobsCount)); subProgress.subTask(indexing); // ratio of the amount of work relative to the total work float ratio = awaitingJobsCount < totalWork ? 1 : ((float) totalWork) / awaitingJobsCount; if (lastJobsCount > awaitingJobsCount) { totalWorked += (lastJobsCount - awaitingJobsCount) * ratio; } else { // more jobs were added, just increment by the ratio totalWorked += ratio; } if (totalWorked - lastWorked >= 1) { subProgress.worked((int) (totalWorked - lastWorked)); lastWorked = totalWorked; } lastJobsCount = awaitingJobsCount; } previousJob = currentJob; } try { if (VERBOSE) Util.verbose("-> GOING TO SLEEP - " + searchJob); // $NON-NLS-1$ Thread.sleep(50); } catch (InterruptedException e) { // ignore } } } finally { synchronized (this) { this.awaitingClients--; } if (t != null && originalPriority > -1 && t.isAlive()) t.setPriority(originalPriority); } } finally { if (subProgress != null) subProgress.done(); } } } status = searchJob.execute( progress == null ? null : new SubProgressMonitor(progress, concurrentJobWork)); } finally { if (progress != null) progress.done(); if (VERBOSE) Util.verbose("FINISHED concurrent job - " + searchJob); // $NON-NLS-1$ } return status; }