Записки искателей » JasperReports

JasperReports 1.3.2

juriy — Wed, 18 Apr 2007 06:26:48 +0000

30-го марта вышел новый релиз JasperReports http://www.jasperforge.org/index.php?option=com_content&task=view&id=286&Itemid=214 . Кроме исправления ошибок и улучшения существующей функциональности JasperReports 1.3.2 представил две новых языковых конструкции $P!{…} и $X{…}.

Оба новых элемента нацелены на поддержку динамических запросов в шаблоне отчета. Напомню, что в предыдущих релизах в элементе queryString можно было использовать значения параметров ($P{…}). В таком случае параметры трактовались как bind переменные (знаки “?” в PreparedStatement). Другими словами, существенно изменить структуру запроса было нельзя.

С выходом JasperReports 1.3.2 ситуация изменилась. С помощью синтаксиса $P!{имя_параметра} в запрос можно передавать параметры, которые будут трактоваться, как текст запроса.
Вторая конструкция $X{…} упрощает работу с выражениями IN (…) и NOT IN(…) – когда количество параметров неизвестно до момента наполнения отчета.
Ниже приведен фрагмент примера из стандартной поставки JasperReports 1.3.2:

[xml]
…

ORDER BY $P!{OrderClause}]]>

…
[/xml]

[java]
…
List excludedCities = new ArrayList();
excludedCities.add(“Boston”);
excludedCities.add(“Chicago”);
excludedCities.add(“Oslo”);
parameters.put(“ExcludedCities”, excludedCities);

parameters.put(“OrderClause”, “City”);

if (TASK_FILL_IGNORE_PAGINATION.equals(taskName)) {
parameters.put(JRParameter.IS_IGNORE_PAGINATION, Boolean.TRUE);
}

JasperFillManager.fillReportToFile(fileName, parameters, getConnection());
System.err.println(“Filling time : ” + (System.currentTimeMillis() – start));
System.exit(0);
…
[/java]

Если с синтаксисом $P!{…} все довольно просто (по сути, он ничем не отличается от $P{…}, то $X{…} я рассмотрю немного детальнее.

Итак, $X{…}, как впрочем и $P{} используется исключительно в элементе queryString. Синтаксис $X{…} – такой:
$X{IN, имя_поля, включения}
$X{NOTIN, имя_поля, исключения}

Литералы IN и NOTIN указывают какое действие следует выполнить: включение (IN) или исключение (NOTIN).
имя_поля – название поля в запросе, над которым следует произвести действие.
включения, исключения – это List значений, которые необходимо включить/исключить.

JasperReports: printing right

juriy — Fri, 23 Mar 2007 14:02:44 +0000

Эта небольшая заметка показывает, как вывести отчет на печать, не экспортируя его в промежуточный формат вроде PDF. Этот код я нашел в блоге Marc Nuri. Марк любезно дал согласие опубликовать этот сниппет в нашем блоге. Думаю, этот материал хорошо дополнит серию уроков о JasperReports.
Оригинал статьи: Choosing a printer programmatically in Jasper Reports


public class PrinterTest {
	public static void main(String[] args) throws PrinterException, JRException {
		JasperPrint print = (JasperPrint) JRLoader.loadObject(
				new File("reports/fill/example1.jrprint"));

		PrinterJob job = PrinterJob.getPrinterJob();
		PrintService[] services = PrintServiceLookup.lookupPrintServices(null, null);
		int selectedService = 0;

		// В этом блоке выбирается принтер, который
		// содержит в своем названии "HP"
		for(int i = 0; i < services.length;i++){
			if(services[i].getName().contains("HP")){
				selectedService = i;
			}
		}

		System.out.println("Selected " + services[selectedService].getName());

		// Морально готовим принтер
		job.setPrintService(services[selectedService]);
		PrintRequestAttributeSet printRequestAttributeSet = new HashPrintRequestAttributeSet();
		MediaSizeName mediaSizeName = MediaSize.findMedia(4, 4, MediaPrintableArea.INCH);
		printRequestAttributeSet.add(mediaSizeName);
		printRequestAttributeSet.add(new Copies(1));

		// Экспортируем
		JRPrintServiceExporter exporter;
		exporter = new JRPrintServiceExporter();
		exporter.setParameter(JRExporterParameter.JASPER_PRINT, print);
		exporter.setParameter(JRPrintServiceExporterParameter.PRINT_SERVICE,
				services[selectedService]);
		exporter.setParameter(JRPrintServiceExporterParameter.PRINT_SERVICE_ATTRIBUTE_SET,
				services[selectedService].getAttributes());
		exporter.setParameter(JRPrintServiceExporterParameter.PRINT_REQUEST_ATTRIBUTE_SET,
				printRequestAttributeSet);
		exporter.setParameter(JRPrintServiceExporterParameter.DISPLAY_PAGE_DIALOG,
				Boolean.FALSE);
		exporter.setParameter(JRPrintServiceExporterParameter.DISPLAY_PRINT_DIALOG,
				Boolean.FALSE);
		exporter.exportReport();
		System.out.println("Done");
	}
}

Посмотрим на код еще раз: сначала выбираются все доступные принт-сервисы. Затем среди доступных принт сервисов выбирается тот, который содержит в названии строку “HP”.
Затем для выбранного сервиса устанавливаются параметры печати: размер бумаги и количество копий.
Затем создается экземпляр JRPrintServiceExporter, который передает отчет принтеру.

JasperReports grouping

juriy — Tue, 20 Mar 2007 08:56:30 +0000

Возможность группировать данные, и подсчитывать показатели группы (количество элементом, среднее значение некоторого поля и.т.д.) – мощный инструмент формирования гибких отчетов. Именно об этом инструменте и пойдет речь в новой заметке о JasperReports. Вторая часть заметки посвящена возможностям выражений (expressions) в JasperReports.

Все статьи

Группировка данных.

Ниже представлен небольшой пример кода, с которым мы будем работать. Исходный отчет показывает список всех заказчиков: имя, фамилию и среднемесячные затраты.






	"
			:
			String.valueOf($F{spendings}.intValue())]]>

Пример четвертый. Выделить другим стилем ячейку, если затраты больше 400.

Этот пример требует некоторых дополнительных пояснений. У элемента reportElement есть необязательный подэлемент: printWhenExpression. В качестве expression необходимо передать java.lang.Boolean. Если вычисление даст результат true, то элемент, который описывается этим reportElement, будет напечатан, иначе не будет.
Чтобы реализовать идею выделения нужных элементов цветом, необходимо сделать вот что:

1. Создать два стиля – green и red – для выделения “хороших” и “плохих” клиентов.
2. Создать два одинаковых блока – один поверх другого. “Нижний” (“красный”) блок будет отображаться всегда. “Трюк” заключается в том, что верхний блок будет отображаться только в том случае, когда значение $F{spendings} больше 400

Вот листинг, который иллюстрирует этот прием:






	
		форматирования с помощью textElement]]>

Обратите внимание на pdfFontName – имя шрифта для PDF, при генерации pdf атрибуты вроде isItalic и isBold – будут проигнорированы. Внешний вид шрифта определяется в файле .ttf. и, строго говоря, Tahoma и Tahoma bold это разные шрифты. Таким образом, чтобы сделать pdf с курсивом, необходимо указывать “курсивный” шрифт. Для примера я взял timesi.ttf. С другой стороны для HTML отчета такие “изыски” не обязательны. Аттрибутов isUnderline и isStrikeThrough эти ограничения не касаются – чтобы создать соответствующий эффект достаточно провести линию: “под” или “через” текст, соответственно. Начертание самого шрифта не меняется, поэтому указывать pdfFontName не нужно.

Установка фона для отчета.
Бывают ситуации, когда необходимо установить фон – логотип компании или водяной знак “конфиденциально”. Реализовать эту задачу можно, воспользовавшись тегом “background”.
Замечание: установка фона никак не отразится на отчетах, проэкспортированных в HTML и в xls. Эти форматы не поддерживают фоновых изображений. Очевидно, что для форматов plain text и csv большинство “стилистических изысков” тоже не пригодится.
Вот пример кода, который показывает, как добавить фон: