Блог о разработке ПО

Немножко магии от AspectJ

noreply@blogger.com (Oleg Atamanenko) — Fri, 27 Jan 2012 19:43:00 +0000

Наверно, вы уже сталкивались с таким понятием, как AOП - аспектно-ориентированное программирование.

Обычно, про него вспоминают, когда говорят про декларативное использование транзакций, про проверку прав доступа, либо про реализацию журналирования.

Но это не единственные области применения АОП.

Я хочу показать ещё пару областей применения из реальных проектов:

1. Модификация исходного кода для реализации дополнительных возможностей.
2. Принудительная проверка контракта между модулями.

Модификация исходного кода для реализации дополнительных возможностей

Предположим, что у нас есть модуль в приложении, который предоставляет нужную нам функциональность. С модулем всё в порядке, кроме одного - все его методы могут выбрасывать проверяемые исключения, что ведёт к ухудшению читаемости кода, так как вместо простого вызова метода:

service.doUsefulThing();

наш вызов превращается в

try {
        service.doUsefulThing();
    } catch ( FirstServiceException e) {
        processException(e);
    } catch ( SecondServiceException e) {
        processException(e);
    }

Дополнительная проблема в том, что у модуля количество модулей 10+, количество методов также велико, что приводит к тому, что блоки try/catch замусоривают код. Решение с использованием паттерна Callback также приведёт к замусориванию кода.

Вариант решения проблемы с использованием AOP

Решение данной проблемы было таким - а что, если используя возможности AOP трансформировать проверяемое исключение в непроверяемое? Таким образом, мы сможем избавиться от скучной проверки на исключения в нашем коде, а для обработки исключения (ведь мы всегда его будем обрабатывать одинаково) достаточно будет использовать обработку исключения на верхнем уровне абстракции.

Для более элегантного решения проблемы было решено добавить собственную аннотацию, которой нужно помечать метод, который использует сервис из "плохого" модуля.

package com.blogger.atamanenko;

import java.lang.annotation.Documented;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
@Documented
@Inherited
public @interface SuppressExceptions {
}

А также аспект, который бы делал всю нужную нам функциональность:

public aspect ExceptionSupressingAspect {

        declare soft :ServiceException:  execution(@com.blogger.atamanenko.annotation.SuppressExceptions * *.*(..));

}

Данный аспект делает в точности следующее: "Смягчает" исключение ServiceException для метода, который помечен аннотацией @SuppressExceptions.

Пример использования:

@SuppressExceptions
    protected Entity findEntity(final Identifiable id) {
        return entityService.findById(id);
    }

Принудительная проверка контракта между модулями

Часто нам необходимо принудительно требовать выполнения каких-то архитектурных ограничений, например, контроллеры должны работать только с сервисами и им запрещено напрямую обращаться к базе данных.

Для реализации таких проверок можно также использовать возможности AOP.

Предположим, что в нашем приложении модуль сервиса выставляет наружу DTO для работы, скрывая при этом классы модели. Для того, чтобы явно запретить доступ к классам и методам модели нам необходимо создать аспект, который бы вызывал ошибку компиляции при нарушении ограничения.

aspect ForbidAccessToModelAspect {

//      Full prohibition of access to model:
        pointcut accessModel(): call(* com.blogger.atamanenko.app.model..*.*(..));
        declare error: accessModel() : "Illegal call to model";

}

После объявления такого аспекта, мы получим ошибку компиляции, что, очевидным образом, приведёт к выполнению архитектурного ограничения.

Если же нам необходимо разрешить доступ к одному пакету только из какого-то определённого другого, то мы можем модифицировать наш аспект следующим образом:

aspect ForbidAccessToModelAspect2 {

        pointcut accessModel(): call(* com.blogger.atamanenko.app.model.**.*(..));

        // Allow access to model from specific package for methods and constructors
        pointcut allowAccessModelFromSpecificPackage(): withincode(* com.blogger.atamanenko.app.allowedpackage..*.*(..));
        pointcut allowAccessModelFromSpecificPackage2(): withincode(com.blogger.atamanenko.app.allowedpackage..*.new(..));

        // forbid usage from any other methods.
        declare error: accessModel() && !(allowAccessModelFromSpecificPackage() || allowAccessModelFromSpecificPackage()):"Illegal call to Model from forbidden package";

}

Такой аспект, созданный в нашем модуле запретит нам использовать классы модели из всех пакетов, кроме com.blogger.atamanenko.app.allowedpackage

Сборка приложения

Файл аспекта нужно положить в каталог src/main/aspect, а для сборки приложения необходимо использовать не стандартный Oracle Java Compiler, а AspectJ compiler.

Пример конфигурации для Apache Maven:

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>aspectj-maven-plugin</artifactId>
    <version>${aspectj-maven-plugin.version}</version>
    <configuration>
        <complianceLevel>1.6</complianceLevel>
        <aspectLibraries>
            <aspectLibrary>
                <groupId>org.springframework</groupId>
                <artifactId>spring-aspects</artifactId>
            </aspectLibrary>
        </aspectLibraries>
        <verbose>true</verbose>
    </configuration>
    <executions>
        <execution>
            <phase>process-sources</phase>
            <goals>
                <goal>compile</goal>
                <goal>test-compile</goal>
            </goals>
        </execution>
    </executions>
</plugin>

Заключение

Вот в общем-то и всё. Я сознательно не стал описывать языковые конструкции аспектов, так как они подробно описаны в руководстве AspectJ

Немного о виртуальных методах в Java

noreply@blogger.com (Oleg Atamanenko) — Thu, 21 Jul 2011 05:06:00 +0000

Сегодня я хочу рассмотреть некоторые особенности переопределения методов в Java. В java нельзя переопределить:

поля класса
конструкторы, инициализаторы класса
статические методы
статические поля

Подробнее об этом можно прочитать в Java Language Specification, §8.4.8

Итак, в java все нестатические неприватные (то есть, protected, package и public) методы являются виртуальными. Ключевое слово final запрещает возможность дальнейшего переопределения метода в подклассах. Рассмотрим следующий пример:

public class A {
     int i = 3;
     int getI() {return i;}
}

public class B extends A{
     int i = 5;
     int getI() {return i;}
}

A a = new B();
System.out.println(a.i);
System.out.println(a.getI());

Вопрос: что выведет данный код?
Ответ:
1. Так как поля класса не наследуются, то у класса A своё поле i и у класса B тоже своё поле i. Так как для полей полиморфизм не действует, то при обращении a.i мы обращаемся к классу A, поэтому на экран будет выведено 3.
2. При вызове метода a.getI() у нас в дело вступает полиморфизм, поэтому будет вызван метод от класса, инстанс которого был создан. Соответственно, мы получим на выходе 5.

Другой пример:

public class A {
     static int i = 3;
     static int getI() {return i;} 
}

public class B extends A{
     static int i = 5;
     static int getI() {return i;}
}

A a = new B();
System.out.println(a.i);
System.out.println(a.getI());

Статические поля и методы виртуальными не являются, поэтому оба вызова выведут нам 3.

Сокращаем ссылки на андроиде

noreply@blogger.com (Oleg Atamanenko) — Mon, 06 Dec 2010 17:11:00 +0000

Вступление

Встала передо мной задача - сокращать ссылки перед тем, как отправлять их в Twitter. Для решения этой задачи я решил использовать bit.ly, благо, их API внятный и простой.

Программируем!

Решение нарисовалось в виде следующего класса:

import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIUtils;
import org.apache.http.client.utils.URLEncodedUtils;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import org.json.JSONException;
import org.json.JSONObject;

import android.util.Log;

import java.io.IOException;
import java.net.URI;
import java.net.URISyntaxException;
import java.util.ArrayList;
import java.util.List;


/**
 * Helper class to work with bitly.
 *
 * @author Oleg Atamanenko
 * @since 06-Dec-2010 12:49:36
 */
public class Bitly {

    private static final String TAG = "Bitly";

    private static final String SHORTEN = "/v3/shorten";
    private static final String API_URL = "api.bit.ly";
    private static final String RESPONSE_FORMAT = "json";

    private String username;
    private String apiKey;


    public Bitly(String username, String apiKey) {
        this.username = username;
        this.apiKey = apiKey;
    }

    public String shorten(String longUrl) throws BitlyException {
        DefaultHttpClient httpClient = new DefaultHttpClient();

        try {
            List params = new ArrayList();
            params.add(new BasicNameValuePair("login", username));
            params.add(new BasicNameValuePair("apiKey", apiKey));
            params.add(new BasicNameValuePair("longUrl", longUrl));
            params.add(new BasicNameValuePair("format", RESPONSE_FORMAT));


            URI uri = URIUtils.createURI("http", API_URL, -1, SHORTEN, URLEncodedUtils.format(params, "UTF-8"), null);
            HttpGet request = new HttpGet(uri);

            Log.d(TAG, "Sending request: " + request.getURI());

            HttpResponse httpResponse = httpClient.execute(request);

            HttpEntity httpEntity = httpResponse.getEntity();
            String response = EntityUtils.toString(httpEntity);
            Log.i(TAG, "Bitly response is: " + response);
            httpResponse.getEntity().consumeContent();

            JSONObject jsonResponse = new JSONObject(response);

            checkForExceptions(jsonResponse);

            JSONObject data = jsonResponse.getJSONObject("data");
            return data.getString("url");

        } catch (ClientProtocolException e) {
            throw new BitlyException(e);
        } catch (IOException e) {
            throw new BitlyException(e);
        } catch (JSONException e) {
            throw new BitlyException(e);
        } catch (URISyntaxException e) {
            throw new BitlyException(e);
        }
    }

    private void checkForExceptions(JSONObject jsonResponse) throws JSONException, BitlyException {
        int statusCode = jsonResponse.getInt("status_code");
        if (statusCode != 200) {
            String message = jsonResponse.getString("status_txt");
            throw new BitlyException(message);
        }
    }

}

Конструктор класс принимает на вход следующие параметры:

userName - имя пользователя bit.ly.
apiKey - Ключ для доступа к API, его можно узнать на специальной страничке

Полная документация к Bit.ly API расположена на отдельном проекте в Google Code

Использование

Единственный метод, реализованный сейчас - это метод shorten(). На вход требуется подать полную ссылку longUrl, на выходе получается укороченная версия ссылки, либо кидается исключение с сообщением от bit.ly API.

Пример вызова

Bitly bitly = new Bitly(BITLY_USERNAME, BITLY_API_KEY);
String shortLink = bitly.shorten(link);

Дальнейшие улучшения

Если перед вами стоит задача быстренько сократить ссылку - то вышеприведённого кода достаточно. Но если вам нужно полноценное решение, со всеми возможностями bit.ly - то посмотрите в сторону bitlyj. Правда, я не уверен, что оно взведётся под андроидом.

Удаление различных диакритических символов из строки

noreply@blogger.com (Oleg Atamanenko) — Fri, 21 May 2010 17:52:00 +0000

Возникла проблема - каким образом заменить в строке символы из национальных кодировок на соответствующие им из латиницы.

Например, из строки explicación получить explicacion.

package com.blogspot.atamanenko;

import java.text.Normalizer;
import java.text.Normalizer.Form;

public class StringNormalizer {

    public static String normalize(String string) {
        return Normalizer.normalize(string, Form.NFD)
            .replaceAll("\\p{InCombiningDiacriticalMarks}+", "");
    }
}

Вызов Normalizer.normalize проводит нормализацию входной строки. Последующий вызов регулярного выражения удаляет все диакритические знаки, полученные после нормализации.

Создание больших объёмов тестовых данных с помощью Databene Benerator

noreply@blogger.com (Oleg Atamanenko) — Fri, 21 May 2010 17:26:00 +0000

Периодически необходимо решать задачу создания больших ( и не очень) объёмов тестовых данных для проведения различных видов тестирования - функционального, нагрузочного (тестирование стабильности и производительности). При этом часто получается так, что система на тестовых данных ведёт себя совсем иначе, чем на реальных данных. Причина кроется в том, что создать правдоподобные тестовые данные всегда достаточно сложно.

Изучая данный вопрос я наткнулся на замечательный фреймворк - Databene Benerator, основной целью создания которого как раз и является создание правдоподобных тестовых данных для проведения различных видов тестирования.

Установка

Установка фреймворка осуществляется двумя способами - как отдельное приложение и как плагин для Maven.

Установка под Maven

Для использования Databene benerator в проектах, использующих для сборки Apache Maven необходимо добавить в зависимости databene-benerator и сконфигурировать его.

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.myorganization</groupId>
  <artifactId>databene-benerator-test</artifactId>
  <version>1.0</version>
  <packaging>jar</packaging>
  <name>data generation project</name>
  <dependencies>
    <dependency>
      <groupId>org.databene</groupId>
      <artifactId>databene-benerator</artifactId>
      <version>0.5.9</version>
    </dependency>
    <dependency>
      <groupId>org.databene</groupId>
      <artifactId>databene-webdecs</artifactId>
      <version>0.4.9</version>
    </dependency>
    <dependency>
      <groupId>org.databene</groupId>
      <artifactId>databene-commons</artifactId>
      <version>0.4.9</version>
    </dependency>
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.6</version>
    </dependency>
  </dependencies>
  <build>
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
      </resource>
    </resources>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
          <encoding>UTF-8</encoding>
          <source>1.5</source>
          <target>1.5</target>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.databene</groupId>
        <artifactId>maven-benerator-plugin</artifactId>
        <version>0.5.9</version>
        <executions>
          <execution>
            <phase>compile</phase>
            <goals>
              <goal>generate</goal>
            </goals>
          </execution>
        </executions>
        <configuration>
          <descriptor>src/main/resources/benerator.ben.xml</descriptor>
          <encoding>UTF-8</encoding>
          <validate>true</validate>
          <dbUrl>jdbc:mysql://localhost:3306/hrtool?useUnicode=true&characterEncoding=UTF-8</dbUrl>
          <dbDriver>com.mysql.jdbc.Driver</dbDriver>
          <dbSchema>database</dbSchema>
          <dbUser>user</dbUser>
          <dbPassword>password</dbPassword>
        </configuration>
        <dependencies>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.13</version>
            <scope>runtime</scope>
          </dependency>
          <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi</artifactId>
            <version>3.5-beta5</version>
            <scope>runtime</scope>
          </dependency>
        </dependencies>
      </plugin>
    </plugins>
  </build>
</project>

В конфигурации необходимо указать как минимум следующие параметры:

dbUrl - строка подключения к базе данных в формате JDBC
dbDriver - используемый драйвер базы данных
dbSchema - имя схемы базы данных
dbUser - имя пользователя, под которым подключаемся к базе данных
dbPassword - пароль пользователя для подключения к базе данных

Кроме использования файла pom.xml databene поддерживает возможность указания параметров в файле benerator.properties, что может быть удобно.

Databene benerator обладает следующими возможностями:

Решение проблемы создания данных в общем виде. На данный момент поддерживаются XML и реляционные базы данных, но не за горами поддержка веб-сервисов, SAP и любых других систем через механизм расширений.
Юзабилити. Databene-benerator позволяет упростить создание тестовых данных для сложной модели прикладной области.
Обработка больших объёмов данных.
Высокая производительность.
Поддержка доменных областей.
Качество данных. Фреймворк поддерживает проверку ограничений модели прикладной области.
Компонентная, легкорасширяемая архитектура.
Широкие возможности изменения и настройки генерации тестовых данных
Создание тестовых данных с нуля.
Импорт и анонимизация реальных данных.

В комплекте идёт толковая, но, к сожалению, неполная документация по возможностям.

Несколько слов о GORM

noreply@blogger.com (Oleg Atamanenko) — Sun, 11 Apr 2010 04:45:00 +0000

В данной заметке хочу поделиться некоторыми моментами использования GORM.

GORM - это ORM-фреймворк, используемый в Grails. Реализован он поверх Hibernate, но, при этом, с некоторыми отличными умолчаниями.

Для разработчиков, знающих Hibernate, рекомендую тщательно изучить GORM, так как его поведение в некоторых случаях отлично от Hibernate, что может приводить к различным сюрпризам.

Маппинг один-ко-многим

По умолчанию GORM для связей один ко многим (one-to-many) создаёт таблицу-связку, которая обычно нужна только при связях между сущностями вида многие ко многим. Чтобы исправить это поведение необходимо указать GORM, чтобы он не создавал таблицу связку.

class Person implements Serializable {
  static hasMany = [
    scores: ScoreSheet
  ]
  
  static mapping = {
    scores joinTable: false
  };
}

Использование однонаправленных связей

Если в приложении используются двунаправленные связи и вероятность изменения сущности одновременно несколькими пользователями высокая, то лучше использовать однонаправленные связи для сущностей. Кроме того, лучше проектировать доменные классы таким образом, чтобы связь была не один-ко-многим, а многие к одному.

class Note implements Serializable {
  static belongsTo = [
    person: Person
  ]
}

class Person implements Serializable {
  // person fields.
}

Для работы с Notes необходимо использовать такие запросы:

  Note.findByPerson(person).each { -> };

вместо

  person.notes.each { -> }

Маппинг иерархии классов доменных сущностей

GORM поддерживает только два варианта маппинга иерархии классов, в отличии от Hibernate: Таблица на всю иерархию (table-per-hierarchy), или таблица на каждый подкласс (table-per-subclass). У маппинга table-per-hierarchy есть серьёзный недостаток - подклассы не могут иметь ненулевые поля. Поэтому, если этот недостаток критичен, то необходимо использовать маппинг table-per-subclass.

class Payment {
  Long id
  Long version
  Integer amount

  static mapping = {
    tablePerHierarchy false
  }
}

class CreditCardPayment extends Payment {
  String cardNumber
}

Общение со Skype через D-Bus на Python

noreply@blogger.com (Oleg Atamanenko) — Mon, 22 Mar 2010 17:50:00 +0000

Summary: в данной заметке описывается работа с программой Skype через D-Bus на Python.

Введение

Захотелось мне странного - когда я ухожу домой, мне нужно выключить amarok, kopete и Skype. Собственно, решено было через D-Bus отправлять вышеперечисленным приложениям релевантные сообщения.

Используем dbus-send

Сначала я использовал обычный dbus-send, что оформилось в виде следующего скрипта go2home:

#!/bin/sh

# Stop amarok
dbus-send --session --type=method_call --dest=org.kde.amarok /Player org.freedesktop.MediaPlayer.Stop

# Logout from kopete
dbus-send --session --type=method_call --dest=org.kde.kopete /Kopete org.kde.Kopete.disconnectAll 

# Logout from Skype
skypeapi.py 'SET USERSTATUS OFFLINE'

# Lock screen
dbus-send --session --type=method_call --dest=org.freedesktop.ScreenSaver /ScreenSaver org.freedesktop.ScreenSaver.Lock

Детали и параметры работы команды dbus-send описаны в man-странице

Проблема со скайпом

Со скайпом пришлось немного повозиться, так как для работы с ним необходима постоянная сессия, что нельзя сделать с помощью dbus-send.

Прочитав описание протокола на сайте

был создан нижеследующий скрипт: skypeapi.py

#!/usr/bin/env python
import dbus, sys

def main():
    remote_bus = dbus.SessionBus()
    
    # Check if skype is running.
    system_service_list = remote_bus.get_object('org.freedesktop.DBus', '/org/freedesktop/DBus').ListNames()
    skype_api_found = 0
    for service in system_service_list:
        if service=='com.Skype.API':
            skype_api_found = 1
            break
    if not skype_api_found:
        sys.exit('No running API-capable Skype found')

    # Get skype dbus api
    skype_service = remote_bus.get_object('com.Skype.API', '/com/Skype')

    # Connect to skype.
    answer = skype_service.Invoke('NAME SkypeApiClient')
    if answer != 'OK':
        sys.exit('Could not bind to Skype client')

    # Check if protocol is supported.
    answer = skype_service.Invoke('PROTOCOL 1')
    if answer != 'PROTOCOL 1':
        sys.exit('This test program only supports Skype API protocol version 1')

    # Invoke operations
    for arg in sys.argv:
        skype_service.Invoke(arg)
    
    return 0    

if __name__ == "__main__":
    main()

При первом запуске скрипта появится скайповский диалог с вопросом, можно ли разрешить приложению доступ к скайпу. После нажатия на "Да" Skype добавит наш скрипт в разрешённые и мы сможем управлять скайпом.

После этого для скрипта go2home был создана иконка на панели.

Заключение

Как видно, работа с DBus из Python проста и элегантна. В качестве домашнего упражнения предлагаю написать скрипт, который после разблокирования экрана будет запускать все нужные приложения.

Разработка макроса для TiddlyWiki

noreply@blogger.com (Oleg Atamanenko) — Sun, 21 Mar 2010 14:54:00 +0000

Summary: Пример разработки плагина для TiddlyWiki

Вступление

TiddlyWiki - это вики-движок, полностью написанный на JavaScript и хранящийся в одном файле (как сам движок, так и содержимое). Создатели позиционируют его как "переиспользуемую нелинейную персональную веб записную книжку".

Я давно использую TiddlyWiki в различных целях:

По прямому назначению.
Как систему GTD.
Как домашнюю страницу на компьютере.

Моя домашняя страница на компьютере - это, если говорить терминами TiddlyWiki, тиддлер, содержащий ссылки на страницы, которые я часто посещаю.

Для удобства использования я разработал пару стилей CSS, так что ссылки были крупными.

Исходный код плагина

После длительного использования tiddlywiki в качестве домашней страницы я понял, что мне хочется, чтобы с каждой ссылкой была иконка сайта. Вручную вставлять картинки мне не хотелось, поэтому было решено написать собственный плагин.

/*{{{*/
version.extensions.faviconLinkMacro = {major: 0, minor: 1, revision: 0, date: new Date(2010,3,21)};
// Author: Oleg Atamanenko
config.macros.faviconLink = {}
config.macros.faviconLink.handler = function(place, macroName,  params, wikifier, paramString) {
  var linkBox = createTiddlyElement(place, "span", null, "favIcon", "");

  var args = paramString.parseParams("list",null,true);
  var link = getParam(args, "link", 'false');
  
  if (link != 'false'){
    urlParts = link.split('/');
    imgLink = urlParts[0] + "//" + urlParts[2] + "/favicon.ico";

    var imgElement = createTiddlyElement(linkBox, "img", null, "faviconImage", "");
    imgElement.src = imgLink;
    imgElement.width = 16;
    imgElement.height = 16;

    var linkTitle = getParam(args, "title", 'false');

    if(linkTitle == 'false'){
      linkTitle = link;
    }
    var linkElement = createTiddlyElement(linkBox, "a", null, "faviconLink", linkTitle);
    linkElement.href = link;
    linkElement.target = '_blank';
  }
}

/*}}}*/

Установка плагина

Создаём новый тиддлер, называем его faviconLinkMacro
Помечаем тиддлер тегом systemConfig, тогда TiddlyWiki при открытии страницы его подгрузит.

Использование плагина

Плагин создаёт новый макрос, faviconLink, с двумя параметрами link и title.
Вызов <<faviconLink link:'https://mail.google.com/mail' title:'mail'>> создаёт ссылку с картинкой с GMail

Настройка визульных стилей плагина

Макрос создаёт следующие классы:

span.favIcon
img.faviconImage
a.faviconLink

Пример стилей

.links span {
  display: block;
  position: relative;
  padding: 0.7em;
  margin: 0.3em;
  min-width: 6em;
  float:left;
  text-align: center;
  font-weight: bold;
  font-size: 1.5em;
  font-family: "Gill Sans MT", "Candara", "Arial"; 
  border: 2px solid [[ColorPalette::SecondaryLight]];
  background-color: [[ColorPalette::SecondaryPale]];
}

.links span:hover {
  border: 2px solid [[ColorPalette::SecondaryMid]];
  background-color: [[ColorPalette::SecondaryLight]];
  color: [[ColorPalette::PrimaryMid]];
}

.links img.faviconImage {
  position: relative;
  padding-right: 10px;
}

Данный CSS необходимо добавить в тиддлер с именем StyleSheet

Пример тиддлера со ссылками

{{links{
<<faviconLink link:'http://delicious.com/dark.schakal/2read' title:'2read'>> <<faviconLink link:'https://mail.google.com/mail' title:'mail'>> <<faviconLink link:'http://www.google.com/reader/view' title:'rss'>> <<faviconLink link:'http://atamanenko.blogspot.com/' title:'blog'>> <<faviconLink link:'http://feedburner.google.com/fb/a/myfeeds' title:'feedburner'>> <<faviconLink link:'https://www.google.com/analytics/settings/' title:'analytics'>> <<faviconLink link:'http://wave.google.com' title:'wave'>> <<faviconLink link:'http://www.blogger.com/home' title:'blogger'>> <<faviconLink link:'http://twitter.com/' title:'twitter'>> <<faviconLink link:'https://www.dropbox.com/home#/' title:'dropbox'>> <<faviconLink link:'http://translate.google.com/toolkit/' title:'translator'>> <<faviconLink link:'http://sibir.megafon.ru/sendsms/' title:'SendSMS'>>
}}}

Вышеприведённый код тиддлера создаёт следующую страницу:

Борьба с убийцами производительности

noreply@blogger.com (Oleg Atamanenko) — Tue, 16 Mar 2010 15:52:00 +0000

Summary: Мой опыт борьбы с "убийцами производительности".

Постановка проблемы

Иногда бывает так, что хочется отвлечься от работы, от поставленной задачи на какую-нибудь фигню, лишь бы не заниматься текущей задачей. У меня это чаще всего сводилось к тому, что я начинал читать что-нибудь в сети (Google Reader, Habrahabr, LOR, etc).

Истоки проблемы могут быть абсолютно разными, например:

Долгий запуск среды разработки
Долгая сборка проекта
Нудная задача
Неинтересная задача

Все эти причины спокойно могут приводить к потере производительности, причём неявным образом, например - "А посижу пока я на хабре, пока полная сборка идёт", в итоге после 20 минут обнаруживается, что сборка закончилась уже 15 минут назад.

Так как у меня тайм-киллер вполне простой - интернет, то и решение вполне простое.

Вот список действий, что я сделал:

Удалил быстрые браузеры, теперь у меня только Mozilla Firefox под Linux и страшный Internet Explorer 6.0 под Windows.
Забанил сайты которые не нужны для работы, но на которых я провожу много времени.

Сначала я сделал радикальный бан - внёс в /etc/hosts эти сайты:

127.0.0.1 www.linux.org.ru linux.org.ru
127.0.0.1 www.habrahabr.ru habrahabr.ru
127.0.0.1 www.lorquotes.ru lorquotes.ru

Но потом обнаружилось, что есть ещё Google Reader, который также отнимает много времени (у меня было до 200 подписок, что давало до 300 новых статей в сутки). Проблему с Google Reader я решал поэтапно:

Почистил список лент от юмора, который обновляется практически ежедневно, является пожирателем трафика и времени.
После этого я почистил список лент от лент, которые достаточно интересные, но при этом без них можно спокойно обходиться (Например, блог Аарона Сейго, одного из главных разработчиков KDE)

Вышеперечисленные действия помогли мне сократить список фидов с 200 сначала до 100 с небольшим, а затем и до 65. Но я понимал, что это ещё не предел и есть к чему стремиться, поэтому решил перейти к использованию оффлайнового RSS-клиента.

Для этого я экспортировал OPML-файл с подписками из Google Reader, удалил все ленты (к сожалению, удалить аккаунт на Google Reader невозможно, только полностью Google Account) и импортировал на Akregator на домашней машинке. Это помогло мне аккумулировать все чтения ленты новостей в один временной промежуток - вечером, дома.

Но, как оказалось, ещё есть к чему стремиться и гугление на просторах сети дало свои результаты: LeechBlock.

LeechBlock это расширение для Mozilla Firefox, которое позволяет блокировать отдельные сайты на различные промежутки времени.

Собственно, начав им пользоваться, я понял, что это именно то, что мне нужно:

Возможности данного расширения следующие:

Блокировка сайтов различные периоды времени
Блокировка сайтов по временному диапазону, в том числе по дням недели.
Поддержка нескольких наборов сайтов для блокировки
Возможность быстрого добавления сайта в список для блокировки

Конечно, данное расширение не является панацеей, его нужно использовать в комплексе с другими средствами.

Список для проверки при оптимизации Grails приложений

noreply@blogger.com (Oleg Atamanenko) — Sat, 06 Feb 2010 17:31:00 +0000

Выкладываю ниже список задач, которые нужно/можно выполнить для оптимизации приложения, написанного на Grails, может кому пригодится.

Тестирование проведённых оптимизаций

Первым делом необходимо разработать критерии проверки, которые позволят оценить эффективность проведённых оптимизаций.

Установить Java Melody плагин для Grails для проведения анализа.
Разработать скрипты для проведения нагрузочного тестирования.
Прогнать скрипты.
Проанализировать результаты Java Melody, выявить узкие места, произвести нужные оптимизации.

Общие оптимизации

Очень часто обновление до последней версии используемых библиотек попутно улучшает производительность.

Обновить Java до последней версии
Обновить Groovy до последней версии.
Обновить Grails до последней версии.
Обновить jQuery до последней версии.
Оптимизировать настройки виртуальной машины Java (например, -server -Xmx270m -Xms270m -XX:MaxPermSize=80m -Xverify:none -XX:+UseParallelGC -XX:+UseParallelOldGC -XX:+UseAdaptiveSizePolicy -XX:SurvivorRatio=4 -XX:TargetSurvivorRatio=90 -XX:MaxTenuringThreshold=31 -XX:+AggressiveOpts)
a. http://java.sun.com/javase/technologies/hotspot/gc/gc_tuning_6.html
Вообще, по оптимизации JVM написаны целые книги, так что не буду здесь останавливаться.

Оптимизация клиентской части

Настроить кэширование статических ресурсов в Томкате.
Настроить сжатие статических ресурсов в Томкате.
(поставить прокси на nginx для кэширования статических ресурсов ?)
Установить плагины для Firebug, которые оценят производительность клиентской части.
- PageSpeed
- YSlow
Проанализировать страницы веб-сайта с их помощью
Провести предлагаемые оптимизации.

Оптимизация клиентской части приложений, написанных на Grails

Установить плагин UI Performance
Провести оптимизацию с использованием плагина UI Performance

Оптимизация базы данных

Оптимизировать производительность сервера базы данных (SQL Server)
a. http://www.sql-server-performance.com/tips/all_main.aspx
a. http://msdn.microsoft.com/en-us/library/ms998577.aspx
Проверить наличие индексов в базе данных, добавить необходимые
Найти неоптимальные запросы в БД, оптимизировать

Оптимизация работы с базой данных

Обновить версию JDBC-драйвера
Настроить кэширование в Hibernate.
Ресурсов в сети предостаточно, навскидку вот парочка.

Оптимизация серверной части приложения

Произвести профилирование приложения (использовать Visual VM, YJP Profiler), найти узкие места и оптимизировать их.

Оптимизация серверной части приложения (опционально)

Установить плагин Perf4J для грэйлза
Добавить необходимые счётчики в код
Прогнать нагрузочные тесты, найти узкие места, оптимизировать.

Заключение

В целом, в данном списке нет ничего нового, это всего лишь компиляция публично доступных материалов. Тем не менее, решил это опубликовать, чтобы сэкономить время другим.

Вложенные транзакции в базах данных

noreply@blogger.com (Oleg Atamanenko) — Thu, 04 Feb 2010 19:20:00 +0000

Summary: Некоторые особенности вложенных транзакций.

Иногда бывает так, что при обработке запроса необходимо открыть ещё одну транзакцию в рамках текущей транзакции. Это называется вложенной транзакцией.

Очень многие базы данных не поддерживают вложенные транзакции вообще, например, MySQL и Oracle. А те, что поддерживают, делают это на минимальном уровне, например, Sybase поддерживает только псевдовложенные транзакции.

Вложенные транзакции могут быть следующих видов:

Псевдо-вложенные транзакции
Вложенная субтранзакция
Вложенная независимая транзакция

Псевдовложенные транзакции

Этот тип транзакций поддерживается базой данных Sybase.
Псевдо-вложенные транзакции позволяют использовать транзакции одна внутри другой, при этом не реализуя механизм вложенных транзакций. Суть состоит в том, что имеется счётчик уровня вложенности транзакций, который увеличивается на 1 при каждом вызове BEGIN TRANSACTION и уменьшается на 1 при каждом вызове COMMIT. Когда счётчик становится равным 0 происходит коммит всех произведённых изменений.

Если во время проведения транзакции происходит ошибка, то вызывается ROLLBACK, но здесь есть загвоздка - что делать с последующими вызовами BEGIN TRANSACTION и COMMIT. Оптимальным решением является кидание исключения, но это необходимо отслеживать и учитывать на стадии проектирования и реализации, чтобы не возникло неприятных ситуаций при эксплуатации.

Псевдовложенные транзакции являются самым простым способом реализации вложенных транзакций.

Пример псевдотранзакции для базы данных Sybase:

begin tran
    select @@trancount
    /* @@trancount = 1 */
    begin tran
        select @@trancount
        /* @@trancount = 2 */
        begin tran
            select @@trancount
            /* @@trancount = 3 */
        commit tran
    commit tran
commit tran
select @@trancount
/* @@ trancount = 0 */

Вложенная субтранзакция

Данный вид вложенных транзакций решает проблему с обработкой ошибок при ROLLBACK.
При коммите вложенной транзакции происходит коммит, но он не обладает свойством Durability - окончательный результат зависит от результата внешней транзакции - если внешняя транзакция заканчивается успешно, то и результат внутренней транзакции также фиксируется. Если же при фиксации изменений внешней транзакции происходит ошибка, то внутренняя транзакция также откатывается. Кроме того, необходимо обратить внимание на то, что если внутренняя транзакция заканчивается неуспешно, то внешняя транзакция может закончиться успешно, если не выкинуть исключение наружу. Таким образом, для данного вида вложенных транзакций необходимо выкидывать исключение наружу, для того, чтобы прервать и откатить внешнюю транзакцию в случае ошибки.

Вложенная независимая транзакция

Особенность данного вида вложенных транзакций заключается в том, что после создания вложенной транзакции она является полностью независимой от транзакции, внутри которой она была создана. Её результаты фиксируются и откатываются независимо от внешней транзакции.

Вложенные транзакции и принципы ACID

Вложенные транзакции выглядят достаточно подозрительными в том смысле, что они могут нарушать принципы ACID:
1. Вложенная субтранзакция может нарушать принцип Durability, так как уже зафиксированные изменения могут откатиться в случае отката внешней транзакции.
2. Вложенная независимая транзакция может нарушать принципы Atomicity и Consistency при возникновении ошибок во внешней или вложенной транзакции.

Подробнее о принципах ACID можно прочитать в этом посте.

Заключение

Я считаю, что следует избегать ситуаций, когда нужны вложенные транзакции. Кроме того, спецификация Java EE не поддерживает вложенные транзакции.

Настройка autofs для монтирования NFS-ресурсов

noreply@blogger.com (Oleg Atamanenko) — Mon, 14 Dec 2009 17:14:00 +0000

Summary: В данной заметке описана настройка autofs для доступа к сетевым ресурсам, доступным по NFS.

Последние несколько лет (с тех пор, как количество компьютеров дома стало больше одного) возникла проблема беспрепятственного доступа к данным, хранящимся на одном компьютере с другого.

Было найдено самое простое решение - NFS.

Как выяснилось позже это было не самое удачное решение - ноутбук не всегда находился дома, а, значит, домашние сетевые ресурсы не всегда доступны. Соответственно, при загрузке операционной системы происходили задержки из-за поиска компьютера с сетевыми ресурсами. Не очень удобно, но жить можно.

Решил окончательно разобраться с этим и начал искать решение. Оно оказалось на поверхности и затронуло только клиента ресурсов, то есть ноутбук. Решение называется autofs.

1. Устанавливаем autofs.

sudo aptitude install autofs5 nfs-common

2. Производим настройку.
Редактируем файл /etc/auto.master. Расскомментируем строку, содержащую строки /net -hosts:

/net -hosts
+auto.master

3. В файл /etc/hosts можно внести адреса серверов с NFS-ресурсами (для того, чтобы избежать DNS-запросов). В моём случае:

192.168.18.1 server

4. Перезапускаем сервис autofs

sudo service autofs restart

5. Теперь открываем в файловом браузер адрес /net/server и видим его сетевые ресурсы, доступные для данного клиента.

6. Пользуемся.

Расширение для работы с Delicious доступно на сайте расширений Google Chrome

noreply@blogger.com (Oleg Atamanenko) — Tue, 08 Dec 2009 17:43:00 +0000

Итак, расширение для работы с Delicious доступно на сайте расширений Google Chrome.

Посмотреть и установить

Новые версии расширения буду закачить на этот сайт.

Использование Dropbox для хранения конфигурационных файлов

noreply@blogger.com (Oleg Atamanenko) — Tue, 08 Dec 2009 17:17:00 +0000

Есть такой замечательный сервис - Dropbox.

Этот сервис является онлайн-хранилищем ваших данных. Работает очень просто:

1. Вы регистрируетесь в сервисе.
2. Устанавливаете клиент
3. Пользуетесь.

Недавно я понял, что этот сервис можно легко и непринуждённо использовать не только для хранения различных документов и фотографий, а также и конфигурационных файлов приложений, что существенно упрощает жизнь, когда у вас несколько рабочих машин (например, у меня домашний компьютер, ноутбук, а также ещё и рабочий) - необходимо каким-то образом синхронизовать конфиги при изменении их на одной из машине с другими.

Итак, что я сделал.

Нижеприведённые действия я делал на одной машине:
1. Создал каталог ConfigFiles
2. Переместил в него свои конфигурационные файлы (~/.zshrc, ~/.zsh, ~/.vimrc, ~/.vim)
3. Из каталога Dropbox сделал соответствующие симлинки в домашнем каталоге.

На каждой из машин
1. Удалил существовавшие конфигурационные файлы
2. Сделал симлинки файлов из Dropbox на соответствующие конфигурационные файлы.

В случае с ZSH (впрочем, для любого другого шелла это тоже реализуется) есть ещё один приятный лайфхак - если на разных машинах должны быть немного разные конфиги (например, другая переменная PATH, CDPATH, то это тоже реализуется просто:

Внесите в свой ~/.zshrc следующий код.

LOCAL_ENVIRONMENT=~/.environment_`hostname`
if [[ -a $LOCAL_ENVIRONMENT ]]
then
    source $LOCAL_ENVIRONMENT
fi

Теперь нужно создать в домашнем каталоге файл с локальной конфигурацией:

touch ~/.environment_`hostname`

И внести в него конфигурацию, локальную для машины.

Да, этот файл тоже может быть симлинком на файл из dropbox.

P.S. Если вас заинтересовал сервис, то прошу вас регистироваться по реферальной ссылке, тогда и вам и мне добавят +250 мегабайт бесплатно.

P.P.S. Да, ещё забыл сказать, что сервис достаточно умный и отправляет дельты файлов во время синхронизации. Подробнее - в официальной документации.

Дайджест ссылок в RSS-ленте

noreply@blogger.com (Oleg Atamanenko) — Mon, 07 Dec 2009 13:25:00 +0000

Решил убрать дайджест ссылок из RSS-ленты.

Те, кому это нужно могут сделать следующее:

1. Добавить в свой RSS-аггрегатор ленту http://feeds.delicious.com/v2/rss/dark.schakal?count=15
2. Если вы используете сервис Delicious, то можете меня добавить меня в свою сеть по ссылке: http://delicious.com/settings/networkadd?networkadd=dark.schakal

RSS лента блога и дайджест ссылок за предыдущий день

noreply@blogger.com (Oleg Atamanenko) — Sat, 05 Dec 2009 19:32:00 +0000

Как вы уже могли заметить, RSS теперь содержит дайджест интересных мне ссылок, которые я нашёл в сети за последнее время.

Отпишитесь в комментариях стоит ли это оставить, или убрать дайджест ссылок из ленты?

RabbitVCS - расширение для Nautilus для работы с Subversion

noreply@blogger.com (Oleg Atamanenko) — Sat, 05 Dec 2009 19:03:00 +0000

Раньше я использовал коллекцию скриптов nautilussvn, весьма неудобную в использовании.

Бродя по просторам сети наткнулся на отличную замену. Встречайте - RabbitVCS.

Возможности

Интеграция с Nautilus
Поддержка Subversion
Полная локализация
Поддержка командной строки
Доступны пакеты для различных дистрибутивов

Установка

Для Ubuntu Hardy, Intepid, Jaunty

deb http://ppa.launchpad.net/rabbitvcs/ppa/ubuntu hardy main

Для Ubuntu Karmic

sudo add-apt-repository ppa:rabbitvcs/ppa

Установка для других дистрибутивов описана на официальном сайте.

Работа

Несмотря на очень маленький номер версии работает достаточно стабильно, не падает.

Скриншоты

После установки внешний вид наутилуса преображается и выглядит примерно следующим образом (картинки кликабельны):

Диалог коммита выглядит вот так:

Контекстное меню:

Заключение

Достойный аналог TortoiseSVN под линукс.

Расширение Delicious Plugin идёт в массы

noreply@blogger.com (Oleg Atamanenko) — Wed, 25 Nov 2009 17:16:00 +0000

Google запустил сайт Chrome Extensions.

В данный момент сайт доступен только разработчикам расширений. Залил расширение, написал кратенькое описание. Жду запуска сайта. :)

А пока сайт закрыт для рядовых пользователей последнюю версию можно скачать тут.

P.S. А тем временем работа над расширением продолжается.

P.P.S. У расширения появилась своя страничка в сети: Project Home Page

Создание страницы настроек для расширений Google Chrome

noreply@blogger.com (Oleg Atamanenko) — Tue, 24 Nov 2009 17:09:00 +0000

В продолжение предыдущей заметки

Логично предположить, что у расширений могут быть настройки. В Google Chrome/Chromium для этого есть специальный API.

Для того, чтобы создать собственную страницу настроек необходимо сделать следующее:

1. Объявить в манифесте страницу настроек

{
  "name": "Delicious plugin", 
  "version": "0.2", 
  "background_page": "background.html", 
  "options_page": "options.html"
}

2. Реализовать страницу с настройками.

Страница с настройками - это обычная HTML-страничка. Для доступа к настройкам Google Chrome предоставляет объект localStorage, который умеет сохранять и возвращать значения.

С объектом localStorage работа идёт как с обычным hash.

<html>
<head>
<title>Delicious Bookmarks Options</title>
</head>
<script type="text/javascript">
    // Saves options to localStorage.
    function saveOptions() {
        var share = document.getElementById("share");
        localStorage["markPrivate"] = share.checked;

        // Update status to let user know options were saved.
        var status = document.getElementById("status");
        status.innerHTML = "Options Saved.";
        setTimeout(function() {
            status.innerHTML = "";
        }, 1500);
    }

    // Restores select box state to saved value from localStorage.
    function restoreOptions() {
        var share = localStorage["markPrivate"];

        if (!share) {
            return;
        }
        var shareCheckbox = document.getElementById("share");

        shareCheckbox.checked = share;
        
    }
</script>

<body onload="restoreOptions()">

<label for="share">Mark as Private</label>
<input type="checkbox" class="checkbox" name="share" id="share" />


<br>
<button onclick="saveOptions();">Save</button>
<div id="status">&nbsp;</div>
</body>
</html>

Чтение настроек

При инициализации страницы настроек необходимо проставить актуальные значения. Для этого на событе onload навешивается функция restoreOptions(), которая проставляет в пользовательском интерфейсе текущие настройки.

Запись настроек

Для сохранения настроек навешивается обработчик onclick для кнопки save - метод saveOptions.

Вот таким простым способом можно сохранять настройки расширения.

Документация

Расширение Delicious Bookmarks для Google Chrome/Chromium

noreply@blogger.com (Oleg Atamanenko) — Sat, 14 Nov 2009 16:34:00 +0000

Введение

Решил научиться писать собственные расширения для Google Chrome/Chromium.

За идею взял официальное расширение от Yahoo! для Firefox - Delicious Bookmarks.

Структура расширения

Расширение - файл с расширением .crx. На самом деле это просто ZIP-архив с файлом манифеста внутри.

Файл манифеста

{
"name": "Delicious plugin", // 1
"version": "0.2", // 2
"background_page": "background.html", // 3
"permissions": [ // 4
"bookmarks",
"tabs"
],

"browser_action": { // 5
"name": "Save bookmark to delicious.com",
"default_title": "Save bookmark to delicious.com",
"default_icon": "delicious.20.gif" // optional
},

"content_scripts": [ // 6
{
"matches": ["http://*/*", "https://*/*"],
"js": ["getDocumentSelection.js"]
}
],

"options_page": "options.html" // 7
}

Манифест - файл в формате JSON.

Манифест состоит из следующих частей:

1. name - Имя расширения
2. version - Версия расширения
3. background_page - основной файл с расширением. Это обычный HTML-файл с разметкой.
4. permissions - разрешения для расширения. Указываем, что нам нужен доступ к вкладкам (tabs) и закладкам (bookmarks).
5. browser_action - указываем, что нужно отобразить на панели инструментов браузера.
6. content_scripts - Для доступа к DOM отображаемой страницы необходимы content scripts, данный блок регистрирует скрипт getDocumentSelection.js для всех http и https страниц.
7. options_page - страница с настройками.

Подробное описание файла манифеста есть на официальном сайте.

Описание работы расширения

Расширение работает следующим образом:
1. При клике на значок расширения вызывается обработчик addBookmark
2. Обработчик открывает коммуникационный порт и отправляет сообщение скрипту содержимого.
3. Скрипт содержимого забирает выделенный текст и отправляет назад расширению выделенный текст.
4. Расширение забирает выделенный текст, определяет настройки сохранения (Private/Public) и вызывает окно сохранения Delicious.

Реализация расширения

background.html:

<html>
<head>
<script type="text/javascript">
    function saveBookmark() {
        // Send our password to the current tab when clicked.
        chrome.tabs.getSelected(null, function(tab) {
            var port = chrome.tabs.connect(tab.id, {
                name : "deliciousBookmark"
            });
            port.postMessage( {
                action : 'getSelection'
            });
        });
    }

    function addBookmark(id, bookmark) {
        console.log("added bookmark:  " + bookmark);
        saveBookmark();
    }

    chrome.bookmarks.onCreated.addListener(addBookmark);
    console.log("Registered listener");

    function getShareStatus() {
        var markPrivate = localStorage["markPrivate"];
        var share = "yes";
        if (markPrivate == "true") {
            share = "no";
        }
        return share;
    }

    chrome.extension.onConnect.addListener(function(port) {
        console.assert(port.name == "deliciousBookmark");
        port.onMessage.addListener(function(msg) {
            var selection = msg.selection;
            chrome.tabs.getSelected(null, function(tab) {

                var url = encodeURIComponent(tab.url);

                if (!url || url === "") {
                    return;
                }

                var title = encodeURIComponent(tab.title);
                var description = encodeURIComponent(selection);

                var share = getShareStatus();

                var f = 'http://delicious.com/save?url=' + url + '&title=' + title + '&notes=' + description
                        + '&share=' + share + '&v=5&';
                window.open(f + 'noui=1&jump=doclose', 'deliciousuiv5',
                        'location=yes,links=no,scrollbars=no,toolbar=no,width=550,height=550');

            });
        });
    });

    chrome.browserAction.onClicked.addListener(saveBookmark);
</script>
</head>
</html>

getDocumentSelection.js

var port = chrome.extension.connect( {
name : "deliciousBookmark"
});

// Also listen for new channels from the extension for when the button is
// pressed.
chrome.extension.onConnect.addListener(function(port) {
console.assert(port.name == "deliciousBookmark");
port.onMessage.addListener(function(msg) {
if (msg.action == 'getSelection') {
var responsePort = chrome.extension.connect( {
name : "deliciousBookmark"
});
var description = document.getSelection() ? '' + document.getSelection() : '';
responsePort.postMessage( {
selection : description
});
}
});
});

options.html

<html>
<html>
<head>
<title>Delicious Bookmarks Options</title>
</head>
<script type="text/javascript">
    // Saves options to localStorage.
    function saveOptions() {
        var share = document.getElementById("share");
        localStorage["markPrivate"] = share.checked;

        // Update status to let user know options were saved.
        var status = document.getElementById("status");
        status.innerHTML = "Options Saved.";
        setTimeout(function() {
            status.innerHTML = "";
        }, 1500);
    }

    // Restores select box state to saved value from localStorage.
    function restoreOptions() {
        var share = localStorage["markPrivate"];

        if (!share) {
            return;
        }
        var shareCheckbox = document.getElementById("share");

        shareCheckbox.checked = share;
        
    }
</script>

<body onload="restoreOptions()">

<label for="share">Mark as Private</label>
<input type="checkbox" class="checkbox" name="share" id="share" />


<br>
<button onclick="saveOptions();">Save</button>
<div id="status">&nbsp;</div>
</body>
</html>

Сборка расширения

В Chromium есть возможность собрать расширение.
1. Открываем адрес chrome://extensions/
2. В правом верхнем углу нажимаем Developer Mode.
3. На появившейся панели инструментов кликаем Pack Extension
4. Выбираем каталог, в котором находится расширение
5. Chromium автоматически собирает расширение в каталоге с исходниками расширения.

Заключение

Писать расширения для Google Chrome не просто, а очень просто.

Готовое и собранное расширение можно скачать здесь.

Дополнительная информация

В следующей заметке опишу работу messaging для коммуникации расширения со скриптами содержимого.

Инвайты на Google Wave

noreply@blogger.com (Oleg Atamanenko) — Mon, 02 Nov 2009 17:26:00 +0000

Кому нужны инвайты на Google Wave, отписываемся в комментариях - поделюсь. UPD. Инвайты закончились, всем спасибо.

Двунаправленная ссылочная целостность

noreply@blogger.com (Oleg Atamanenko) — Tue, 07 Jul 2009 15:11:00 +0000

Здравствуйте.

Я считаю, что разработчику всегда стоит иметь представление о том, как работают низлежащие абстракции. Хотя бы потому, что часто абстракции бывают протекающими.

А веду я это к тому, что когда фреймворк вываливает стектрейс с несколькими вложенными (и, часто, для непосвященных непонятными) исключениями, то бывает непонятно, что с этим делать, особенно, если не знаешь, как реализована абстракция.

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

Вопрос - каким образом вставлять в базу данных такие сущности?

При вставке в таблицу в Player нам нужно уже иметь запись в таблице Statistics, а для вставки в таблицу Statistics нужно знать идентификатор игрока, к которому относится эта запись.

Выглядит замкнутым кругом, но решение есть.

Во-первых, вставки в обе таблицы должны происходить в рамках одной транзакции (как я уже писал, транзакция обеспечивает перевод базы данных из одного непротиворечащего состояния в другое непротиворечащее состояние).

К сожалению, этого недостаточно:

begin transaction;

INSERT INTO "Player"  VALUES (10, 20);
INSERT INTO "Statistics"  VALUES (20, 10);

commit;

выдаёт следующую ошибку:

ERROR: insert or update on table "Player" violates foreign key constraint "statisticsId"
SQL state: 23503
Detail: Key (statisticsId)=(20) is not present in table "Statistics".

И снова кажется, что замкнутый круг не разорвать.

Но решение всё же есть.
Многие базы данных позволяют нарушать консистентность базы данных внутри транзакции. В данном случае можно "попросить" базу данных отложить проверку ссылочной целостности. На примере PostgreSQL рассмотрим, как это работает.

PostgreSQL

begin transaction;

set constraints all deferred; -- 1

INSERT INTO "Player"  VALUES (10, 20);
INSERT INTO "Statistics"  VALUES (20, 10);

set constraints all immediate; -- 2

commit; -- 3

1 - Сделать все ограничения отложенными. Ограничения будут проверены в момент проведения фиксации транзакции (в строке 3)
2 - Явно делаем все ограничения немедленными. В данном примере это необязательно, так как в 3) они всё равно будут проверены.

После выполнения данного кода получаем:

Query returned successfully with no result in 24 ms.

Это уже полностью рабочий пример, чтобы это заработало нужно явно сделать ограничения отложенными - они должны быть объявлены как DEFERRED. Официальная документация к PostgreSQL гласит:

Upon creation, a constraint is given one of three characteristics: DEFERRABLE INITIALLY DEFERRED, DEFERRABLE INITIALLY IMMEDIATE, or NOT DEFERRABLE. The third class is always IMMEDIATE and is not affected by the SET CONSTRAINTS command. The first two classes start every transaction in the indicated mode, but their behavior can be changed within a transaction by SET CONSTRAINTS.

Так что необходимо также модифицировать объявления ограничений:

ALTER TABLE "Player"
ADD CONSTRAINT "statisticsId" FOREIGN KEY ("statisticsId")
REFERENCES "Statistics" ("statisticsId") MATCH SIMPLE
ON UPDATE NO ACTION ON DELETE NO ACTION DEFERRABLE INITIALLY IMMEDIATE;

Данный пример был приведён для PostgreSQL.

Для других баз данных решения следующие:

Sybase

В Sybase есть переменная WAIT_FOR_COMMIT, которая управляет поведением проверки ограничений. По умолчанию она отключена. Кроме того, это поведение можно переопределить при объявлении можно указывать CHECK ON COMMIT. Подробнее можно посмотреть в официальной документации.

Oracle

Также, как и в PostgreSQL:

You can define constraints as either deferrable or not deferrable, and either initially deferred or initially immediate. These attributes can be different for each constraint. You specify them with keywords in the CONSTRAINT clause:
DEFERRABLE or NOT DEFERRABLE
INITIALLY DEFERRED or INITIALLY IMMEDIATE

Constraints can be added, dropped, enabled, disabled, or validated. You can also modify a constraint's attributes.

Подробнее в официльной документации.

mySQL

К сожалению, mySQL не имеет возможности отложенной проверки ограничении, о чём в документации и сказано:

Deviation from SQL standards: Like MySQL in general, in an SQL statement that inserts, deletes, or updates many rows, InnoDB checks UNIQUE and FOREIGN KEY constraints row-by-row. According to the SQL standard, the default behavior should be deferred checking. That is, constraints are only checked after the entire SQL statement has been processed. Until InnoDB implements deferred constraint checking, some things will be impossible, such as deleting a record that refers to itself via a foreign key.

Но это не конец света, так как можно отключить проверку внешних ключей:

SET foreign_key_checks = 0;
-- code goes here
SET foreign_key_checks = 1;

Чем эта информация может быть полезна для разработчика? Например, в случае, если ошибки и недоработки Hibernate покажут себя в виде стектрейса в логе(например, HHH-2248), то разработчик будет понимать причину ошибки и то, как реализовать work-around.

Opera и del.icio.us

noreply@blogger.com (Oleg Atamanenko) — Fri, 03 Jul 2009 18:13:00 +0000

Так получилось, что в последнее время я стал пользоваться небезызвестной оперой. В связи с этим я стал искать замену часто используемым расширениям, одно из них - delicious bookmarks. Сервис del.icio.us предоставляет букмарклеты для различных браузеров, которые позволяют сохранять закладки быстро и удобно. Вот только есть один недостаток - официальный плагин для Firefox в свойство Notes новой закладки добавляет выделенный текст со страницы, чего букмарклет не делает. Посмотрев исходник букмарклета, а это обычный javascript, я добавил небольшой кусочек кода, который восстанавливает справедливость и тоже добавляет в поле Notes текст, выделенный на странице. Ниже привожу изменённый код букмарклета:

javascript:(function(){f='http://delicious.com/save?url='+encodeURIComponent(window.location.href)+'&title='+encodeURIComponent(document.title)+'¬es='+encodeURIComponent(document.getSelection())+'&v=5&';a=function(){if(!window.open(f+'noui=1&jump=doclose','deliciousuiv5','location=yes,links=no,scrollbars=no,toolbar=no,width=550,height=550'))location.href=f+'jump=yes'};if(/Firefox/.test(navigator.userAgent)){setTimeout(a,0)}else{a()}})()

Spring Roo (часть 2)

noreply@blogger.com (Oleg Atamanenko) — Sat, 06 Jun 2009 15:19:00 +0000

Архитектура сгенерированного приложения

Spring Roo активно использует аспекты. В качестве реализации аспектов была взята библиотека aspectj. Большая часть сгенерированного кода попадает в отдельные файлы-аспекты. Создадим простой класс:

new persistent class jpa -name ~.domain.Action -testAutomatically
add field string name -notNull -sizeMin 1 -sizeMax 80
add field string description -sizeMax 1024

Spring Roo создаст нам следующие файлы:

Action.java Класс содержит только полезную с точки зрения назначения класса информацию. По сути, то, что вводит разработчик в консоль Roo аккумулируется здесь. Весь дополнительный код разносится по другим классам.
```
@Entity //1
@RooJavaBean //2
@RooToString //3
@RooEntity(finders = { "findActionsByName" }) //4
public class Action {

@NotNull
@Size(min = 1, max = 80)
private String name;


@Size(max = 1024)
private String description;
}
```
1) Класс является JPA-сущностью. 2) Аннотация @RooJavaBean говорит, что этот класс - обычный Java-бин. 3) Аннотация @RooToString говорит, что у этого класса есть перегруженный метод toString(). 4) Аннотация @RooEntity говорит что класс является JPA-сущностью.
Action_Roo_Configurable.aj Данный аспект говорит, что класс Action является конфигурируемым через Spring.
```
privileged aspect Action_Roo_Configurable {
declare @type: Action: @org.springframework.beans.factory.annotation.Configurable;
}
```

Action_Roo_Entity.aj В данном классе собраны все методы DAO для работы с классом Action.

package org.academ.uthark.research.roo.domain;

privileged aspect Action_Roo_Entity {

@javax.persistence.PersistenceContext
transient javax.persistence.EntityManager Action.entityManager;

@javax.persistence.Id
@javax.persistence.GeneratedValue(strategy = javax.persistence.GenerationType.AUTO)
@javax.persistence.Column(name = "id")
private java.lang.Long Action.id;

@javax.persistence.Version
@javax.persistence.Column(name = "version")
private java.lang.Integer Action.version;

public java.lang.Long Action.getId() {
return this.id;
}

public void Action.setId(java.lang.Long id) {
this.id = id;
}

public java.lang.Integer Action.getVersion() {
return this.version;
}

public void Action.setVersion(java.lang.Integer version) {
this.version = version;
}

@org.springframework.transaction.annotation.Transactional
public void Action.persist() {
if (this.entityManager == null) throw new IllegalStateException("Entity manager has not been injected (is the Spring Aspects JAR configured as an AJC/AJDT aspects library?)");
this.entityManager.persist(this);
}

@org.springframework.transaction.annotation.Transactional
public void Action.remove() {
if (this.entityManager == null) throw new IllegalStateException("Entity manager has not been injected (is the Spring Aspects JAR configured as an AJC/AJDT aspects library?)");
this.entityManager.remove(this);
}

@org.springframework.transaction.annotation.Transactional
public void Action.flush() {
if (this.entityManager == null) throw new IllegalStateException("Entity manager has not been injected (is the Spring Aspects JAR configured as an AJC/AJDT aspects library?)");
this.entityManager.flush();
}

@org.springframework.transaction.annotation.Transactional
public void Action.merge() {
if (this.entityManager == null) throw new IllegalStateException("Entity manager has not been injected (is the Spring Aspects JAR configured as an AJC/AJDT aspects library?)");
Action merged = this.entityManager.merge(this);
this.entityManager.flush();
this.id = merged.getId();
}

public static long Action.countActions() {
return (Long) new Action().entityManager.createQuery("select count(o) from Action o").getSingleResult();
}

public static java.util.List Action.findAllActions() {
return new Action().entityManager.createQuery("select o from Action o").getResultList();
}

public static org.academ.uthark.research.roo.domain.Action Action.findAction(java.lang.Long id) {
if (id == null) throw new IllegalArgumentException("An identifier is required to retrieve an instance of Action");
return new Action().entityManager.find(Action.class, id);
}

public static java.util.List Action.findActionEntries(int firstResult, int maxResults) {
return new Action().entityManager.createQuery("select o from Action o").setFirstResult(firstResult).setMaxResults(maxResults).getResultList();
}

}

Как легко видеть, этот аспект добавляет классу Action CRUD-методы, поля id и version.

Action_Roo_Finder.aj Этот аспект аккумулирует все finder-методы, созданные через консоль Spring Roo.

privileged aspect Action_Roo_Finder {

public static javax.persistence.Query Action.findActionsByName(java.lang.String name) {
if (name == null) throw new IllegalArgumentException("The name argument is required");
javax.persistence.Query q = new Action().entityManager.createQuery("FROM Action AS action WHERE action.name = :name");
q.setParameter("name", name);
return q;
}

}

Action_Roo_JavaBean.aj Для уменьшения загромождения кода ненужными методами для доступа к полям Spring Roo выносит их в отдельный аспект.

privileged aspect Action_Roo_JavaBean {

public java.lang.String Action.getName() {
return this.name;
}

public void Action.setName(java.lang.String name) {
this.name = name;
}

public java.lang.String Action.getDescription() {
return this.description;
}

public void Action.setDescription(java.lang.String description) {
this.description = description;
}

}

Action_Roo_Plural.aj В данном аспекте можно определить, как созданная сущность выглядит во множественном числе.

package org.academ.uthark.research.roo.domain;

privileged aspect Action_Roo_JavaBean {

public java.lang.String Action.getName() {
return this.name;
}

public void Action.setName(java.lang.String name) {
this.name = name;
}

public java.lang.String Action.getDescription() {
return this.description;
}

public void Action.setDescription(java.lang.String description) {
this.description = description;
}

}

Action_Roo_ToString.aj Аспект, переопределяющий toString()

privileged aspect Action_Roo_ToString {

public java.lang.String Action.toString() {
StringBuilder sb = new StringBuilder();
sb.append("id: ").append(getId()).append(", ");
sb.append("version: ").append(getVersion()).append(", ");
sb.append("name: ").append(getName()).append(", ");
sb.append("description: ").append(getDescription()).append(", ");
return sb.toString();
}

}

ActionEditor.java Кроме того, при создании контроллеров для работы дополнительно создается ActionEditor
```
import org.springframework.roo.addon.property.editor.RooEditor;

@RooEditor(providePropertyEditorFor = Action.class)
public class ActionEditor {
}
```

ActionEditor_Roo_Editor.aj Аспект с реализацией.

privileged aspect ActionEditor_Roo_Editor {

declare parents: ActionEditor implements java.beans.PropertyEditorSupport;

org.springframework.beans.SimpleTypeConverter ActionEditor.typeConverter = new org.springframework.beans.SimpleTypeConverter();

public java.lang.String ActionEditor.getAsText() {
 Object obj = getValue(); 
 if (obj == null) { 
     return null;     
 } 
 return (String) typeConverter.convertIfNecessary(((org.academ.uthark.research.roo.domain.Action) obj).getId() , String.class); 
}

public void ActionEditor.setAsText(java.lang.String text) {
 if (text == null || "".equals(text)) { 
     setValue(null);     
     return;     
 } 

 java.lang.Long identifier = (java.lang.Long) typeConverter.convertIfNecessary(text, java.lang.Long.class); 
 if (identifier == null) { 
     setValue(null);     
     return;     
 } 

 setValue(org.academ.uthark.research.roo.domain.Action.findAction(identifier)); 
}

}

А где же equals()/hashCode()?

Легко заметить, что Spring Roo забыл ещё про один важный аспект - про реализацию методов equals() и hashCode(). К релизу, я думаю, эта недоработка будет исправлена. Как видно, код скрипта для генерации весьма и весьма лаконичен, а получающий java-код наглядно показывает всю многословность языка Java.

Apache Maven integration

Spring Roo при создании проекта создаёт pom.xml, хорошо знакомый всем работавшим с maven. Кроме того, консоль позволяет добавлять и удалять зависимости, не правя файл вручную.

Расширения

Spring Roo поддерживает расширения, что ещё больше даёт возможностей. На сегодняшний день написано уже как минимум одно расширение - Sitemesh Addon.

Критика

В первую очередь критика относится к текущему релизу, а так как он ещё в глубокой альфе, то все может измениться к официальному релизу.

Нет возможности подставлять свои JSP-шаблоны для сгенерированного CRUD
В сгенерированном коде есть ошибки, например, если заводим поле типа флоат, создаём контроллер, то при редактировании сущности возможна следующая ошибка: вводим достаточно большое число (1234567), сохраняем сущность, открываем на редактирование. В поле, хранящем флоат получаем 1.23456E7, и после этого невозможно сохранить сущность, так как получаем ошибку валидации.
Ещё одна ошибка связана с отношением один ко многим. Создаём пару сущностей с таким отношением. Запускаем, пробуем создать сущность. Roo умничает, если нет связанных сущностей в БД, то он даже не генерирует <select>

Вывод

В целом, Spring Roo достойное начинание, но пользоваться им в Production можно будет ещё нескоро.

Введение в Spring Roo

noreply@blogger.com (Oleg Atamanenko) — Tue, 02 Jun 2009 17:06:00 +0000

Недавно компания Spring Source презентовала новый продукт - Spring Roo. Цель проекта - повысить продуктивность Java-разработчиков. Почитав обзоры, а также потрогав его руками можно сделать вывод о том, что это, в некотором виде, альтернатива AppFuse и Grails.

Описание Spring Roo

100% программирование на Java, предлагающее разработчикам известную, развитую и популярную платформу разработки.

Прозрачные, надёжные и продуктивные сервисы среды разработки, такие как помощник кода, отладчики, визуальные отчёты об ошибка и т.д.

Экстремально эффективная производительность во время выполнения, безопасность типов и отсутствие зависимостей на Roo во время выполнения.

Автоматическая архитектура с использование лучших практик Spring Framework 3

Структура проекта основана на Maven2.

Работа с БД основана на JPA (например, через Hibernate), 100% совместимость с JPA и переносимость реализации.

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

Прозрачная поддержка внедрения зависимостей (dependency injection) и методов сохранения для всех сущностей, включая полученные через JPA.

Поддержка валидации бинов (JSR 303), включая распространение ограничений вплость до DDL базы данных.

Автоматические интеграционные тесты на JUnit, которые создаются на базе возможностей интеграционного тестирования Spring Framework.

Автоматическая поддержка REST на уровне бэкэнда.

Автоматизированные тесты для веб-слоя с использованием Selenium.

Динамическое создание finder-методов на JPA QL для сущностей безо всякого кодирования.

Интеграция Spring Security, включая безопасность адресов с установкой в одну строку ("install security")

Поддеркжа Spring Web Flow одной командой ("install web flow")

Поддержка мгновенной отправки почтовых сообщение - даже через удалённые SMTP сервера, как GMail.

Встроенная поддержка конфигурирования log4j

Использование URL rewriting которое позволяет оставаться ссылкам чистыми и поддерживающими REST.

Лёгкое ручное создание веб-контроллеров

Поддержка полного цикла жизни приложения с сохранением высокой продуктивности.

Использование встроенного сервлет контейнера Tomcat.

Полная интеграция с Eclipse и SpringSource Tool Suite

Лёгкая в использовании, с поддержка автодополнения, подсказок и контекста командная строка

Поддержка автоматизации через скрипты