SEWiki - Вклад участника [ru]

Java 2013

2013-05-22T22:46:49Z

Snurk: /* Лекции */

Лектор - Кузнецов Антон

Практика - Нурк Сергей

== Рейтинг ==

[https://docs.google.com/spreadsheet/pub?key=0Aif17q2hwUt4dG12aDM0MjI3NlJiOVdXVHpXNVA4alE&output=html Текущий рейтинг]

== Условия получения зачета ==

Зачет автоматом (оценка - отлично):
#Азаров Андрей
#Карташев Дмитрий
#Козятинский Алексей
#Ломшаков Вадим
#Орлов Андрей
#Пивоваров Алексей
#Савенко Сергей
#Шабалин Александр

Зачет полуавтоматом (подойти и обсудить с АМ условия получения зачета)
#Гулецкий Артур
#Мартынов Семен
#Таланов Павел

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

Примерное количество баллов
#на оценку удовлетворительно - 50
#на оценку хорошо - 60
#на оценку отлично - 70

== Лекции ==

*[[Java_2013-02-08|Лекция 1]]
*[[Медиа:Java_2013_02.ppt|Лекция 2]]
*[http://neerc.ifmo.ru/~kgeorgiy/courses/java-advanced/slides/exceptions.pps Лекция 3 (часть 1)] [[Медиа:Java_2013_03_2.ppt|Лекция 3 (часть 2)]]
*[[Java_2013-02-27|Лекция 4]]
*[[Медиа:Java_2013_05.ppt|Лекция 5 (часть 2)]]
*[[Медиа:Java_2013_05-2.ppt|Лекция 6]]
*[[Медиа:Java_2013_06.ppt|Лекция 7 (Reflection)]]
*[[Медиа:Java_2013_08.ppt|Лекция 8 (Многопоточное программирование)]]
*[[Медиа:Java_2013_09.ppt|Лекция 9 (java.util.concurrent)]]
*[[Java_Swing_2013|Лекция 10]]
*[[Java_Serialization_2013|Лекция 11]]

== Задания ==
* [http://mit.spbau.ru/sewiki/images/3/35/Java_hmw_2013_02_20.pdf Первое задание] срок сдачи: 20 февраля
* [http://mit.spbau.ru/sewiki/images/e/e4/Java_hmw_2013_02_27.pdf Второе задание] срок сдачи: 27 февраля
* [http://mit.spbau.ru/sewiki/images/d/db/Java_hmw_2013_03_06.pdf Третье задание] срок сдачи: 06 марта
* [[Java_2013_HW4|Четвертое задание]] срок сдачи: 13 марта
* [http://mit.spbau.ru/sewiki/images/c/c4/Java_hmw_2013_03_20.pdf Пятое задание] срок сдачи: продлен до 27 марта
* [http://mit.spbau.ru/sewiki/images/7/79/Java_hmw_2013_04_03.pdf Шестое задание] срок сдачи: 3 апреля
* [http://mit.spbau.ru/sewiki/images/f/fb/Java_hmw_2013_04_10.pdf Седьмое задание] срок сдачи: 10 апреля
* [[Java 2013 CW1|Контрольная работа]]
* [[Java_2013_HW8|Восьмое задание]] срок сдачи: 17 апреля
* [http://mit.spbau.ru/sewiki/images/4/4c/Java_hmw_2013_9.pdf Девятое задание] срок сдачи 1 мая или [http://mit.spbau.ru/sewiki/images/7/75/Java_2013_10.pdf Десятое задание] срок сдачи 15 мая и вес 20 баллов. Десятое задание для тех, кто хотел поприменять java.util.concurrent (предупреждение: вам потребуется самостоятельно немного почитать про сеть, сокеты и т.п. )
* [[Java_2013_HW10|Одиннадцатое задание]] срок сдачи 12 мая
* [[Java 2013 CW2|Контрольная работа - 2]]
Присылать задачи нужно на почту sergeynurk@gmail.com с копией anton.m.kuznetsov@gmail.com и темой: Java homework <фамилия> tasks 1,2,3...

Вопросы можно задать по тому же почтовому адресу с темой Java question.

== Рекомендуемая литература ==
* "Thinking in Java", Bruce Eckel
* "Effective Java", Joshua Bloch

== Coding conventions ==
В отличие от C++, для Java есть [http://www.oracle.com/technetwork/java/codeconv-138413.html общепринятые coding conventions] от компании Sun.

В первую очередь обратите внимание на Naming Conventions. Настоятельно рекоммендуется отдавать предпочтение длинным мнемоническим идентификаторам.

== Некоторые требования ==

=== Форма поставки кода ===
Задания должны присылаться в jar архивах. В архивы включаются только ваши исходники (.java файлы).

Для создания архивов используйте [http://docs.oracle.com/javase/tutorial/deployment/jar/build.html утилиту jar].

Каждая задача должна находиться в пакете ru.spbau.<ваша фамилия>.task<# задания>

В качестве точки входа должен использоваться класс с именем Main.

Можете складывать несколько заданий в один архив.

=== Javadoc ===
Ко всем классам, интерфейсам и public/protected полям и методам должен быть написан осмысленный [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags javadoc] на грамотном английском языке.

Javadoc должен быть валидным (в частности, содержать все [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags required tags]).

Настоятельно рекоммендуется использовать консольные или встроенные в IDE средства проверки валидности javadoc.

Пример сносного javadoc-а можно найти в любом классе стандартной библиотеки.

=== Exceptions ===
При проверке ваших решений большое внимание будет уделяться тому как вы работаете с исключениями.

Распространенные недочеты:
* Использование исключений для управления логикой программы
* Оборачивание проверяемых исключений в непроверяемые
* Подавление исключений
* Отсутствие вывода читаемой полезной информации в блоках обработки ошибок
* Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)
* Перехват исключений слишком общeго типа

== Общие замечания ==
* Некоторым вашим классам может понадобиться больше public методов, чем те, которые перечислены в условиях задач.
* Добавление дополнительных уровней абстракции приветствуется в том случае, если вы готовы обосновать принятые вами решения.

== FAQ ==
Q: Можно ли использовать finalize для закрытия открытых файлов?

A: Нет, нельзя. На лекциях обязательно будет разобрано почему.

Q: Нужно ли всегда использовать утилиту ant?

A: Нет, не нужно. С ней обязательно попрактикуемся отдельно, использовать ее не обязательно.

Q: Нужно ли присылать какие-либо файлы помимо .java (metadata, build.xml)?

A: Нет, не нужно. Стандартный манифест файл, генерируемой утилитой jar, конечно можно оставить в архиве.

== Примеры работы с "файловыми" исключениями ==

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

Можете использовать тот, который вам больше по душе.

<source lang="java">
/**
* The way I always tried to use dealing with "file-reading" exceptions.
*/
public static void firstExample() {
String filename = "filename";
try {
BufferedReader reader = new BufferedReader(new FileReader(filename));
String line;
try {
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
}
}

/**
* The way to get rid of one level of try blocks.
* Significantly reduces depth when dealing with several files.
*/
public static void secondExample() {
String filename = "filename";
BufferedReader reader = null;
try {
reader = new BufferedReader(new FileReader(filename));
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
if (reader != null) {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
}
}

/**
* Brand new Java7 way of dealing with this example.
* Uses try-with-resources statement.
* For more information see:
* http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html
* Remark: some exceptions that you dealt with in two previous examples might be suppressed here.
*/
public static void thirdExample() {
String filename = "filename";
try (BufferedReader reader = new BufferedReader(new FileReader(filename))) {
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened. Message: " + e.getMessage());
e.printStackTrace();
}
}
</source>

== Ссылки ==

Java Serialization 2013

2013-05-22T13:21:26Z

Snurk: /* Лекция о сериализации в Java. */

== Что почитать ==

* "Effective Java", Joshua Bloch, Chapter 11
* [http://docs.oracle.com/javase/7/docs/platform/serialization/spec/serialTOC.html Java Object Serialization Specification]

== Материалы лекции ==

<source lang="java">
/****Введение****/

/**
*
* Сериализация -- запись объекта в байтовый поток.
*
* Десереализация -- CO.
*
* Все в пакете java.io
*
* Мотивация:
* 1. dump (ex. JavaBeans persistence)
* 2. RMI
*/
class Point {
double x;
double y;
}

/**
* В простейшем случае достаточно добавить маркерный интерфейс implements
* Serializable
*/
@SuppressWarnings("serial")
class Point1 implements Serializable {
double x;
double y;

Point1(double x, double y) {
this.x = x;
this.y = y;
}

}

class SimplePointTest {
void SimpleWrite(OutputStream os) throws /*NotSerializableException,*/ IOException {
Point1 p = new Point1(10., 10.);
ObjectOutput out = new ObjectOutputStream(os);
out.writeObject(p);
os.flush();
}

void SimpleRead(InputStream is) throws IOException, ClassNotFoundException {
ObjectInput in = new ObjectInputStream(is);
Point1 p = (Point1) in.readObject();
System.out.println("x=" + p.x);
System.out.println("y=" + p.y);
}

@Test
public void SimpleTest() throws FileNotFoundException, IOException,
ClassNotFoundException {
try (OutputStream os = new FileOutputStream("point.ser")) {
SimpleWrite(os);
}

try (InputStream is = new FileInputStream("point.ser")) {
SimpleRead(is);
}
}
}

/****Процесс сериализации****/

/**
* В сериализации участвуют ВСЕ достижимые объекты.
*
* Запись:
* 1. Запись предка (если он сериализуем)
* 2. Запись полей (если они сериализуемы)
*
* Циклические зависимости корректно обрабатываются автоматически.
*
* Чтение:
* 1. Выделение памяти под объект
* 2. Чтение предка
* 3. Чтение полей
*/

/**
* Все поля должны быть сериализуемы!
*/
@SuppressWarnings("serial")
class Polygon implements Serializable {

List<Point3> vertices = new ArrayList<>();

}

/**
* Пока все просто, но впечатление обманчиво!
*
* 1. Внутреннее представление становится частью интерфейса
* Инкапсуляция летит к чертям!
* 2. Увеличивает объемы тестирования новых версий
* 3. Дополнительный конструктор!
* Необходимо обеспечивать все инварианты
* Некоторые дыры в безопасности
* 4. Все потомки становятся сериализуемыми!
*/

/****Управление сериализацией****/

/**
* Serial version UID (stream unique identifier)
*
* Применяется для обеспечения совместимости, когда версии класса изменяются
*
* По-умолчанию автоматически создается на основе имени, интерфейсов,
* public и protected полей
*
* В случае несовпадения -- InvalidClassException
*
*/
class Point2 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double x;
double y;
}

/**
* Модификатор transient.
* Исключает поле из процесса сериализации.
* Примеры:
* 1. Избыточная информация (предподсчитанные значения)
* 2. Несериализуемые поля
*
*/
class Point3 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double x;
double y;
transient int precomputedHash;

public int hashCode() {
return precomputedHash;
}

private int countHash() {
//some very involved procedure
return 0;
}

Point3(double x, double y) {
this.x = x;
this.y = y;
precomputedHash = countHash();
}
}

/**
* Настраиваемая сериализация
* Методы
* readObject(ObjectInputStream in) -- должен прочесть состояние из потока
* writeObject(ObjectOutputStream out) -- должен записать состояние в поток
*
* Процесс чтения
* 1. Выделение памяти
* 2. Вызов readObject
*
*/
class Point4 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double x;
double y;

transient int precomputedHash;

public int hashCode() {
return precomputedHash;
}

private int countHash() {
//some very involved procedure
return 0;
}

Point4(double x, double y) {
this.x = x;
this.y = y;
precomputedHash = countHash();
}

/*
* Отвечает только за запись полей ЭТОГО класса, не предка и не потомка!
*/
private void writeObject(ObjectOutputStream s) throws IOException {
/*
* Реализует стандартный механизм сериализации.
* Может вызываться только из writeObject, иначе NotActiveException
*/
s.defaultWriteObject();
}

//отвечает только за чтение полей ЭТОГО класса, не предка и не потомка!
private void readObject(ObjectInputStream s) throws IOException,
ClassNotFoundException {
/*
* Реализует стандартный механизм десериализации.
* Может вызываться только из readObject, иначе NotActiveException
*/
s.defaultReadObject();
//восстановление инвариантов
precomputedHash = countHash();
}
}

/**
* Что если внутреннее представление класса изменилось?
*
* Ручная сериализация полей
*
* Константа ObjectStreamField[] serialPersistentFields -- сериализуемые поля
* ObjectOutputStream.PutField putFields() -- поля для записи
*
* writeFields записывает поля
*
* ObjectInputStream.GetField readFields() -- чтение полей
*
*/
class Point5 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double angle;
double rad;

private static final ObjectStreamField[] serialPersistentFields = {
new ObjectStreamField("x", double.class),
new ObjectStreamField("y", double.class) };

private void writeObject(ObjectOutputStream s) throws IOException {
ObjectOutputStream.PutField fields = s.putFields();
fields.put("x", Math.cos(angle) * rad);
fields.put("y", Math.sin(angle) * rad);
s.writeFields();
}

private void readObject(ObjectInputStream s) throws IOException,
ClassNotFoundException {
ObjectInputStream.GetField fields = s.readFields();
double x = (double) fields.get("x", 0.);
double y = (double) fields.get("y", 0.);
// count angle and mod here
// angle = ...
// rad = ...
}
}

/**
* Сериализация с несериализуемым предком.
*
* Если хочется отнаследовать сериализуемый класс от
* несериализуемого предка, то могут быть проблемы...
*
* Формальное требование одно -- предок должен иметь
* конструктор по-умолчанию.
*
* Но только ли?!
*/
class NonSerializablePoint {
private double x;
private double y;

protected double getX() {return x;}

protected double getY() {return y;}

protected void init(double x, double y) {
this.x = x;
this.y = y;
}

protected NonSerializablePoint() {}

public NonSerializablePoint(double x, double y) {
init(x, y);
}
}

// Serializable subclass of nonserializable stateful class
class ColoredPoint extends NonSerializablePoint implements Serializable {
private int color;

// Конструктор использует обычный механизм
public ColoredPoint(double x, double y, int color) {
super(x, y);
this.color = color;
}

private void readObject(ObjectInputStream s) throws IOException,
ClassNotFoundException {
s.defaultReadObject();
// Manually deserialize and initialize superclass state
double x = s.readDouble();
double y = s.readDouble();
init(x, y);
}

private void writeObject(ObjectOutputStream s) throws IOException {
s.defaultWriteObject();
// Manually serialize superclass state
s.writeDouble(getX());
s.writeDouble(getY());
}

private static final long serialVersionUID = 1856835860954L;
}

/**
* Externalizable
*
* Сериализация "в ручную"
*
* void readExternal(ObjectInput in)
* void writeExternal(ObjectOutput out)
*
* Должен быть конструктор по-умолчанию
*
* Чтение: вызов конструктора по-умолчанию, вызов readExternal
*/
class Point6 implements Externalizable {
private double x;
private double y;

Point6(double x, double y) {
this.x = x;
this.y = y;
}

@Override
public void writeExternal(ObjectOutput out) throws IOException {
out.writeDouble(x);
out.writeDouble(y);
}
@Override
public void readExternal(ObjectInput in) throws IOException,
ClassNotFoundException {
this.x = in.readDouble();
this.y = in.readDouble();
}
}

/**
* "Подмена" сериализуемого объекта.
*
* Когда вместо самого объекта сериализуется его альтернативное представление
* в виде другого объекта некоторого (возможно того же самого) сериализуемого класса.
*
* Object writeReplace() -- какой объект записать вместо данного
* Object readResolve() -- какой объект восстановить вместо прочитанного
*
* Реализуются у разных классов!!!
*/

</source>

Java Serialization 2013

2013-05-22T13:20:15Z

Snurk: /* Лекция о сериализации в Java. */

== Что почитать ==

* "Effective Java", Joshua Bloch, Chapter 11
* [http://docs.oracle.com/javase/7/docs/platform/serialization/spec/serialTOC.html Java Object Serialization Specification]

== Лекция о сериализации в Java. ==

<source lang="java">
/****Введение****/

/**
*
* Сериализация -- запись объекта в байтовый поток.
*
* Десереализация -- CO.
*
* Все в пакете java.io
*
* Мотивация:
* 1. dump (ex. JavaBeans persistence)
* 2. RMI
*/
class Point {
double x;
double y;
}

/**
* В простейшем случае достаточно добавить маркерный интерфейс implements
* Serializable
*/
@SuppressWarnings("serial")
class Point1 implements Serializable {
double x;
double y;

Point1(double x, double y) {
this.x = x;
this.y = y;
}

}

class SimplePointTest {
void SimpleWrite(OutputStream os) throws /*NotSerializableException,*/ IOException {
Point1 p = new Point1(10., 10.);
ObjectOutput out = new ObjectOutputStream(os);
out.writeObject(p);
os.flush();
}

void SimpleRead(InputStream is) throws IOException, ClassNotFoundException {
ObjectInput in = new ObjectInputStream(is);
Point1 p = (Point1) in.readObject();
System.out.println("x=" + p.x);
System.out.println("y=" + p.y);
}

@Test
public void SimpleTest() throws FileNotFoundException, IOException,
ClassNotFoundException {
try (OutputStream os = new FileOutputStream("point.ser")) {
SimpleWrite(os);
}

try (InputStream is = new FileInputStream("point.ser")) {
SimpleRead(is);
}
}
}

/****Процесс сериализации****/

/**
* В сериализации участвуют ВСЕ достижимые объекты.
*
* Запись:
* 1. Запись предка (если он сериализуем)
* 2. Запись полей (если они сериализуемы)
*
* Циклические зависимости корректно обрабатываются автоматически.
*
* Чтение:
* 1. Выделение памяти под объект
* 2. Чтение предка
* 3. Чтение полей
*/

/**
* Все поля должны быть сериализуемы!
*/
@SuppressWarnings("serial")
class Polygon implements Serializable {

List<Point3> vertices = new ArrayList<>();

}

/**
* Пока все просто, но впечатление обманчиво!
*
* 1. Внутреннее представление становится частью интерфейса
* Инкапсуляция летит к чертям!
* 2. Увеличивает объемы тестирования новых версий
* 3. Дополнительный конструктор!
* Необходимо обеспечивать все инварианты
* Некоторые дыры в безопасности
* 4. Все потомки становятся сериализуемыми!
*/

/****Управление сериализацией****/

/**
* Serial version UID (stream unique identifier)
*
* Применяется для обеспечения совместимости, когда версии класса изменяются
*
* По-умолчанию автоматически создается на основе имени, интерфейсов,
* public и protected полей
*
* В случае несовпадения -- InvalidClassException
*
*/
class Point2 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double x;
double y;
}

/**
* Модификатор transient.
* Исключает поле из процесса сериализации.
* Примеры:
* 1. Избыточная информация (предподсчитанные значения)
* 2. Несериализуемые поля
*
*/
class Point3 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double x;
double y;
transient int precomputedHash;

public int hashCode() {
return precomputedHash;
}

private int countHash() {
//some very involved procedure
return 0;
}

Point3(double x, double y) {
this.x = x;
this.y = y;
precomputedHash = countHash();
}
}

/**
* Настраиваемая сериализация
* Методы
* readObject(ObjectInputStream in) -- должен прочесть состояние из потока
* writeObject(ObjectOutputStream out) -- должен записать состояние в поток
*
* Процесс чтения
* 1. Выделение памяти
* 2. Вызов readObject
*
*/
class Point4 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double x;
double y;

transient int precomputedHash;

public int hashCode() {
return precomputedHash;
}

private int countHash() {
//some very involved procedure
return 0;
}

Point4(double x, double y) {
this.x = x;
this.y = y;
precomputedHash = countHash();
}

/*
* Отвечает только за запись полей ЭТОГО класса, не предка и не потомка!
*/
private void writeObject(ObjectOutputStream s) throws IOException {
/*
* Реализует стандартный механизм сериализации.
* Может вызываться только из writeObject, иначе NotActiveException
*/
s.defaultWriteObject();
}

//отвечает только за чтение полей ЭТОГО класса, не предка и не потомка!
private void readObject(ObjectInputStream s) throws IOException,
ClassNotFoundException {
/*
* Реализует стандартный механизм десериализации.
* Может вызываться только из readObject, иначе NotActiveException
*/
s.defaultReadObject();
//восстановление инвариантов
precomputedHash = countHash();
}
}

/**
* Что если внутреннее представление класса изменилось?
*
* Ручная сериализация полей
*
* Константа ObjectStreamField[] serialPersistentFields -- сериализуемые поля
* ObjectOutputStream.PutField putFields() -- поля для записи
*
* writeFields записывает поля
*
* ObjectInputStream.GetField readFields() -- чтение полей
*
*/
class Point5 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double angle;
double rad;

private static final ObjectStreamField[] serialPersistentFields = {
new ObjectStreamField("x", double.class),
new ObjectStreamField("y", double.class) };

private void writeObject(ObjectOutputStream s) throws IOException {
ObjectOutputStream.PutField fields = s.putFields();
fields.put("x", Math.cos(angle) * rad);
fields.put("y", Math.sin(angle) * rad);
s.writeFields();
}

private void readObject(ObjectInputStream s) throws IOException,
ClassNotFoundException {
ObjectInputStream.GetField fields = s.readFields();
double x = (double) fields.get("x", 0.);
double y = (double) fields.get("y", 0.);
// count angle and mod here
// angle = ...
// rad = ...
}
}

/**
* Сериализация с несериализуемым предком.
*
* Если хочется отнаследовать сериализуемый класс от
* несериализуемого предка, то могут быть проблемы...
*
* Формальное требование одно -- предок должен иметь
* конструктор по-умолчанию.
*
* Но только ли?!
*/
class NonSerializablePoint {
private double x;
private double y;

protected double getX() {return x;}

protected double getY() {return y;}

protected void init(double x, double y) {
this.x = x;
this.y = y;
}

protected NonSerializablePoint() {}

public NonSerializablePoint(double x, double y) {
init(x, y);
}
}

// Serializable subclass of nonserializable stateful class
class ColoredPoint extends NonSerializablePoint implements Serializable {
private int color;

// Конструктор использует обычный механизм
public ColoredPoint(double x, double y, int color) {
super(x, y);
this.color = color;
}

private void readObject(ObjectInputStream s) throws IOException,
ClassNotFoundException {
s.defaultReadObject();
// Manually deserialize and initialize superclass state
double x = s.readDouble();
double y = s.readDouble();
init(x, y);
}

private void writeObject(ObjectOutputStream s) throws IOException {
s.defaultWriteObject();
// Manually serialize superclass state
s.writeDouble(getX());
s.writeDouble(getY());
}

private static final long serialVersionUID = 1856835860954L;
}

/**
* Externalizable
*
* Сериализация "в ручную"
*
* void readExternal(ObjectInput in)
* void writeExternal(ObjectOutput out)
*
* Должен быть конструктор по-умолчанию
*
* Чтение: вызов конструктора по-умолчанию, вызов readExternal
*/
class Point6 implements Externalizable {
private double x;
private double y;

Point6(double x, double y) {
this.x = x;
this.y = y;
}

@Override
public void writeExternal(ObjectOutput out) throws IOException {
out.writeDouble(x);
out.writeDouble(y);
}
@Override
public void readExternal(ObjectInput in) throws IOException,
ClassNotFoundException {
this.x = in.readDouble();
this.y = in.readDouble();
}
}

/**
* "Подмена" сериализуемого объекта.
*
* Когда вместо самого объекта сериализуется его альтернативное представление
* в виде другого объекта некоторого (возможно того же самого) сериализуемого класса.
*
* Object writeReplace() -- какой объект записать вместо данного
* Object readResolve() -- какой объект восстановить вместо прочитанного
*
* Реализуются у разных классов!!!
*/

</source>

Java Serialization 2013

2013-05-22T13:09:56Z

Snurk: /* 1. Serialization.java */

== Что почитать ==

* "Effective Java", Joshua Bloch, Chapter 11
* [http://docs.oracle.com/javase/7/docs/platform/serialization/spec/serialTOC.html Java Object Serialization Specification]

== Лекция о сериализации в Java. ==

<source lang="java">
/****Введение****/

/**
*
* Сериализация -- запись объекта в байтовый поток.
*
* Десереализация -- CO.
*
* Все в пакете java.io
*
* Мотивация:
* 1. dump (ex. JavaBeans persistence)
* 2. RMI
*/
class Point {
double x;
double y;
}

//move to Point1.java and SimplePointTest.java

/****Процесс сериализации****/

/**
* В сериализации участвуют ВСЕ достижимые объекты.
*
* Запись:
* 1. Запись предка (если он сериализуем)
* 2. Запись полей (если они сериализуемы)
*
* Циклические зависимости корректно обрабатываются автоматически.
*
* Чтение:
* 1. Выделение памяти под объект
* 2. Чтение предка
* 3. Чтение полей
*/

/**
* Все поля должны быть сериализуемы!
*/
@SuppressWarnings("serial")
class Polygon implements Serializable {

List<Point3> vertices = new ArrayList<>();

}

/**
* Пока все просто, но впечатление обманчиво!
*
* 1. Внутреннее представление становится частью интерфейса
* Инкапсуляция летит к чертям!
* 2. Увеличивает объемы тестирования новых версий
* 3. Дополнительный конструктор!
* Необходимо обеспечивать все инварианты
* Некоторые дыры в безопасности
* 4. Все потомки становятся сериализуемыми!
*/

/****Управление сериализацией****/

/**
* Serial version UID (stream unique identifier)
*
* Применяется для обеспечения совместимости, когда версии класса изменяются
*
* По-умолчанию автоматически создается на основе имени, интерфейсов,
* public и protected полей
*
* В случае несовпадения -- InvalidClassException
*
*/
class Point2 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double x;
double y;
}

/**
* Модификатор transient.
* Исключает поле из процесса сериализации.
* Примеры:
* 1. Избыточная информация (предподсчитанные значения)
* 2. Несериализуемые поля
*
*/
class Point3 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double x;
double y;
transient int precomputedHash;

public int hashCode() {
return precomputedHash;
}

private int countHash() {
//some very involved procedure
return 0;
}

Point3(double x, double y) {
this.x = x;
this.y = y;
precomputedHash = countHash();
}
}

/**
* Настраиваемая сериализация
* Методы
* readObject(ObjectInputStream in) -- должен прочесть состояние из потока
* writeObject(ObjectOutputStream out) -- должен записать состояние в поток
*
* Процесс чтения
* 1. Выделение памяти
* 2. Вызов readObject
*
*/
class Point4 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double x;
double y;

transient int precomputedHash;

public int hashCode() {
return precomputedHash;
}

private int countHash() {
//some very involved procedure
return 0;
}

Point4(double x, double y) {
this.x = x;
this.y = y;
precomputedHash = countHash();
}

/*
* Отвечает только за запись полей ЭТОГО класса, не предка и не потомка!
*/
private void writeObject(ObjectOutputStream s) throws IOException {
/*
* Реализует стандартный механизм сериализации.
* Может вызываться только из writeObject, иначе NotActiveException
*/
s.defaultWriteObject();
}

//отвечает только за чтение полей ЭТОГО класса, не предка и не потомка!
private void readObject(ObjectInputStream s) throws IOException,
ClassNotFoundException {
/*
* Реализует стандартный механизм десериализации.
* Может вызываться только из readObject, иначе NotActiveException
*/
s.defaultReadObject();
//восстановление инвариантов
precomputedHash = countHash();
}
}

//move to Point5.java

/**
* Сериализация с несериализуемым предком.
*
* Если хочется отнаследовать сериализуемый класс от
* несериализуемого предка, то могут быть проблемы...
*
* Формальное требование одно -- предок должен иметь
* конструктор по-умолчанию.
*
* Но только ли?!
*/
class NonSerializablePoint {
private double x;
private double y;

protected double getX() {return x;}

protected double getY() {return y;}

protected void init(double x, double y) {
this.x = x;
this.y = y;
}

protected NonSerializablePoint() {}

public NonSerializablePoint(double x, double y) {
init(x, y);
}
}

// Serializable subclass of nonserializable stateful class
class ColoredPoint extends NonSerializablePoint implements Serializable {
private int color;

// Конструктор использует обычный механизм
public ColoredPoint(double x, double y, int color) {
super(x, y);
this.color = color;
}

private void readObject(ObjectInputStream s) throws IOException,
ClassNotFoundException {
s.defaultReadObject();
// Manually deserialize and initialize superclass state
double x = s.readDouble();
double y = s.readDouble();
init(x, y);
}

private void writeObject(ObjectOutputStream s) throws IOException {
s.defaultWriteObject();
// Manually serialize superclass state
s.writeDouble(getX());
s.writeDouble(getY());
}

private static final long serialVersionUID = 1856835860954L;
}

/**
* Externalizable
*
* Сериализация "в ручную"
*
* void readExternal(ObjectInput in)
* void writeExternal(ObjectOutput out)
*
* Должен быть конструктор по-умолчанию
*
* Чтение: вызов конструктора по-умолчанию, вызов readExternal
*/
class Point6 implements Externalizable {
private double x;
private double y;

Point6(double x, double y) {
this.x = x;
this.y = y;
}

@Override
public void writeExternal(ObjectOutput out) throws IOException {
out.writeDouble(x);
out.writeDouble(y);
}
@Override
public void readExternal(ObjectInput in) throws IOException,
ClassNotFoundException {
this.x = in.readDouble();
this.y = in.readDouble();
}
}

/**
* "Подмена" сериализуемого объекта.
*
* Когда вместо самого объекта сериализуется его альтернативное представление
* в виде другого объекта некоторого (возможно того же самого) сериализуемого класса.
*
* Object writeReplace() -- какой объект записать вместо данного
* Object readResolve() -- какой объект восстановить вместо прочитанного
*
* Реализуются у разных классов!!!
*/

import java.io.Serializable;

/**
* В простейшем случае достаточно добавить маркерный интерфейс implements
* Serializable
*/
@SuppressWarnings({ "serial"})
public class Point1 implements Serializable {
double x;
double y;

Point1(double x, double y) {
this.x = x;
this.y = y;
}

}

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.ObjectInput;
import java.io.ObjectInputStream;
import java.io.ObjectOutput;
import java.io.ObjectOutputStream;
import java.io.OutputStream;

import org.junit.Test;

@SuppressWarnings("javadoc")
public class SimplePointTest {
void SimpleWrite(OutputStream os) throws /*NotSerializableException,*/ IOException {
Point1 p = new Point1(10., 10.);
ObjectOutput out = new ObjectOutputStream(os);
out.writeObject(p);
os.flush();
}

void SimpleRead(InputStream is) throws IOException, ClassNotFoundException {
ObjectInput in = new ObjectInputStream(is);
Point1 p = (Point1) in.readObject();
System.out.println("x=" + p.x);
System.out.println("y=" + p.y);
}

@Test
public void SimpleTest() throws FileNotFoundException, IOException,
ClassNotFoundException {
try (OutputStream os = new FileOutputStream("point.ser")) {
SimpleWrite(os);
}

try (InputStream is = new FileInputStream("point.ser")) {
SimpleRead(is);
}
}
}

import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.ObjectStreamField;
import java.io.Serializable;

/**
* Что если внутреннее представление класса изменилось?
*
* Ручная сериализация полей
*
* Константа ObjectStreamField[] serialPersistentFields -- сериализуемые поля
* ObjectOutputStream.PutField putFields() -- поля для записи
*
* writeFields записывает поля
*
* ObjectInputStream.GetField readFields() -- чтение полей
*
*/
@SuppressWarnings("unused")
public class Point5 implements Serializable {
private static final long serialVersionUID = 4889340678034881968L;

double angle;
double rad;

private static final ObjectStreamField[] serialPersistentFields = {
new ObjectStreamField("x", double.class),
new ObjectStreamField("y", double.class) };

private void writeObject(ObjectOutputStream s) throws IOException {
ObjectOutputStream.PutField fields = s.putFields();
fields.put("x", Math.cos(angle) * rad);
fields.put("y", Math.sin(angle) * rad);
s.writeFields();
}

private void readObject(ObjectInputStream s) throws IOException,
ClassNotFoundException {
ObjectInputStream.GetField fields = s.readFields();
double x = (double) fields.get("x", 0.);
double y = (double) fields.get("y", 0.);
// count angle and mod here
// angle = ...
// rad = ...
}
}

</source>

Java Serialization 2013

2013-05-22T12:10:58Z

Snurk: /* 1. Serialization.java (основная часть) */

Java Serialization 2013

2013-05-22T12:10:42Z

Snurk: /* 1. Serialization.java (основная часть) */

Java 2013

2013-04-23T17:11:28Z

Snurk: /* Задания */

Лектор - Кузнецов Антон

Практика - Нурк Сергей

== Рейтинг ==

[https://docs.google.com/spreadsheet/pub?key=0Aif17q2hwUt4dG12aDM0MjI3NlJiOVdXVHpXNVA4alE&output=html Текущий рейтинг]

== Лекции ==

*[[Java_2013-02-08|Лекция 1]]
*[[Медиа:Java_2013_02.ppt|Лекция 2]]
*[http://neerc.ifmo.ru/~kgeorgiy/courses/java-advanced/slides/exceptions.pps Лекция 3 (часть 1)] [[Медиа:Java_2013_03_2.ppt|Лекция 3 (часть 2)]]
*[[Java_2013-02-27|Лекция 4]]
*[[Медиа:Java_2013_05.ppt|Лекция 5 (часть 2)]]
*[[Медиа:Java_2013_05-2.ppt|Лекция 6]]
*[[Медиа:Java_2013_06.ppt|Лекция 7]]
*[[Медиа:Java_2013_08.ppt|Лекция 8]]

== Задания ==
* [http://mit.spbau.ru/sewiki/images/3/35/Java_hmw_2013_02_20.pdf Первое задание] срок сдачи: 20 февраля
* [http://mit.spbau.ru/sewiki/images/e/e4/Java_hmw_2013_02_27.pdf Второе задание] срок сдачи: 27 февраля
* [http://mit.spbau.ru/sewiki/images/d/db/Java_hmw_2013_03_06.pdf Третье задание] срок сдачи: 06 марта
* [[Java_2013_HW4|Четвертое задание]] срок сдачи: 13 марта
* [http://mit.spbau.ru/sewiki/images/c/c4/Java_hmw_2013_03_20.pdf Пятое задание] срок сдачи: продлен до 27 марта
* [http://mit.spbau.ru/sewiki/images/7/79/Java_hmw_2013_04_03.pdf Шестое задание] срок сдачи: 3 апреля
* [http://mit.spbau.ru/sewiki/images/f/fb/Java_hmw_2013_04_10.pdf Седьмое задание] срок сдачи: 10 апреля
* [[Java 2013 CW1|Контрольная работа]]
* [[Java_2013_HW8|Восьмое задание]] срок сдачи: 17 апреля
* [http://mit.spbau.ru/sewiki/images/4/4c/Java_hmw_2013_9.pdf Девятое задание] срок сдачи 1 мая или [http://mit.spbau.ru/sewiki/images/7/75/Java_2013_10.pdf Десятое задание] срок сдачи 15 мая и вес 20 баллов. Десятое задание для тех, кто хотел поприменять java.util.concurrent (предупреждение: вам потребуется самостоятельно немного почитать про сеть, сокеты и т.п. )

Присылать задачи нужно на почту sergeynurk@gmail.com с копией anton.m.kuznetsov@gmail.com и темой: Java homework <фамилия> tasks 1,2,3...

Вопросы можно задать по тому же почтовому адресу с темой Java question.

== Рекомендуемая литература ==
* "Thinking in Java", Bruce Eckel
* "Effective Java", Joshua Bloch

== Coding conventions ==
В отличие от C++, для Java есть [http://www.oracle.com/technetwork/java/codeconv-138413.html общепринятые coding conventions] от компании Sun.

В первую очередь обратите внимание на Naming Conventions. Настоятельно рекоммендуется отдавать предпочтение длинным мнемоническим идентификаторам.

== Некоторые требования ==

=== Форма поставки кода ===
Задания должны присылаться в jar архивах. В архивы включаются только ваши исходники (.java файлы).

Для создания архивов используйте [http://docs.oracle.com/javase/tutorial/deployment/jar/build.html утилиту jar].

Каждая задача должна находиться в пакете ru.spbau.<ваша фамилия>.task<# задания>

В качестве точки входа должен использоваться класс с именем Main.

Можете складывать несколько заданий в один архив.

=== Javadoc ===
Ко всем классам, интерфейсам и public/protected полям и методам должен быть написан осмысленный [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags javadoc] на грамотном английском языке.

Javadoc должен быть валидным (в частности, содержать все [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags required tags]).

Настоятельно рекоммендуется использовать консольные или встроенные в IDE средства проверки валидности javadoc.

Пример сносного javadoc-а можно найти в любом классе стандартной библиотеки.

=== Exceptions ===
При проверке ваших решений большое внимание будет уделяться тому как вы работаете с исключениями.

Распространенные недочеты:
* Использование исключений для управления логикой программы
* Оборачивание проверяемых исключений в непроверяемые
* Подавление исключений
* Отсутствие вывода читаемой полезной информации в блоках обработки ошибок
* Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)
* Перехват исключений слишком общeго типа

== Общие замечания ==
* Некоторым вашим классам может понадобиться больше public методов, чем те, которые перечислены в условиях задач.
* Добавление дополнительных уровней абстракции приветствуется в том случае, если вы готовы обосновать принятые вами решения.

== FAQ ==
Q: Можно ли использовать finalize для закрытия открытых файлов?

A: Нет, нельзя. На лекциях обязательно будет разобрано почему.

Q: Нужно ли всегда использовать утилиту ant?

A: Нет, не нужно. С ней обязательно попрактикуемся отдельно, использовать ее не обязательно.

Q: Нужно ли присылать какие-либо файлы помимо .java (metadata, build.xml)?

A: Нет, не нужно. Стандартный манифест файл, генерируемой утилитой jar, конечно можно оставить в архиве.

== Примеры работы с "файловыми" исключениями ==

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

Можете использовать тот, который вам больше по душе.

<source lang="java">
/**
* The way I always tried to use dealing with "file-reading" exceptions.
*/
public static void firstExample() {
String filename = "filename";
try {
BufferedReader reader = new BufferedReader(new FileReader(filename));
String line;
try {
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
}
}

/**
* The way to get rid of one level of try blocks.
* Significantly reduces depth when dealing with several files.
*/
public static void secondExample() {
String filename = "filename";
BufferedReader reader = null;
try {
reader = new BufferedReader(new FileReader(filename));
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
if (reader != null) {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
}
}

/**
* Brand new Java7 way of dealing with this example.
* Uses try-with-resources statement.
* For more information see:
* http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html
* Remark: some exceptions that you dealt with in two previous examples might be suppressed here.
*/
public static void thirdExample() {
String filename = "filename";
try (BufferedReader reader = new BufferedReader(new FileReader(filename))) {
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened. Message: " + e.getMessage());
e.printStackTrace();
}
}
</source>

== Ссылки ==

2013-03-15T22:00:59Z

Snurk: /* Домашние задания */

Лектор - Кузнецов Антон

Практика - Нурк Сергей

== Рейтинг ==

[https://docs.google.com/spreadsheet/pub?key=0Aif17q2hwUt4dG12aDM0MjI3NlJiOVdXVHpXNVA4alE&output=html Текущий рейтинг]

== Лекции ==

*[[Java_2013-02-08|Лекция 1]]
*[[Медиа:Java_2013_02.ppt|Лекция 2]]
*[http://neerc.ifmo.ru/~kgeorgiy/courses/java-advanced/slides/exceptions.pps Лекция 3 (часть 1)] [[Медиа:Java_2013_03_2.ppt|Лекция 3 (часть 2)]]
*[[Java_2013-02-27|Лекция 4]]

== Домашние задания ==
* [http://mit.spbau.ru/sewiki/images/3/35/Java_hmw_2013_02_20.pdf Первое задание] срок сдачи: 20 февраля
* [http://mit.spbau.ru/sewiki/images/e/e4/Java_hmw_2013_02_27.pdf Второе задание] срок сдачи: 27 февраля
* [http://mit.spbau.ru/sewiki/images/d/db/Java_hmw_2013_03_06.pdf Третье задание] срок сдачи: 06 марта
* [[Java_2013_HW4|Четвертое задание]] срок сдачи: 13 марта
* [http://mit.spbau.ru/sewiki/images/c/c4/Java_hmw_2013_03_20.pdf Пятое задание] срок сдачи: продлен до 27 марта

Присылать задачи нужно на почту sergeynurk@gmail.com с копией anton.m.kuznetsov@gmail.com и темой: Java homework <фамилия> tasks 1,2,3...

Вопросы можно задать по тому же почтовому адресу с темой Java question.

== Рекомендуемая литература ==
* "Thinking in Java", Bruce Eckel
* "Effective Java", Joshua Bloch

== Coding conventions ==
В отличие от C++, для Java есть [http://www.oracle.com/technetwork/java/codeconv-138413.html общепринятые coding conventions] от компании Sun.

В первую очередь обратите внимание на Naming Conventions. Настоятельно рекоммендуется отдавать предпочтение длинным мнемоническим идентификаторам.

== Некоторые требования ==

=== Форма поставки кода ===
Задания должны присылаться в jar архивах. В архивы включаются только ваши исходники (.java файлы).

Для создания архивов используйте [http://docs.oracle.com/javase/tutorial/deployment/jar/build.html утилиту jar].

Каждая задача должна находиться в пакете ru.spbau.<ваша фамилия>.task<# задания>

В качестве точки входа должен использоваться класс с именем Main.

Можете складывать несколько заданий в один архив.

=== Javadoc ===
Ко всем классам, интерфейсам и public/protected полям и методам должен быть написан осмысленный [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags javadoc] на грамотном английском языке.

Javadoc должен быть валидным (в частности, содержать все [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags required tags]).

Настоятельно рекоммендуется использовать консольные или встроенные в IDE средства проверки валидности javadoc.

Пример сносного javadoc-а можно найти в любом классе стандартной библиотеки.

=== Exceptions ===
При проверке ваших решений большое внимание будет уделяться тому как вы работаете с исключениями.

Распространенные недочеты:
* Использование исключений для управления логикой программы
* Оборачивание проверяемых исключений в непроверяемые
* Подавление исключений
* Отсутствие вывода читаемой полезной информации в блоках обработки ошибок
* Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)
* Перехват исключений слишком общeго типа

== Общие замечания ==
* Некоторым вашим классам может понадобиться больше public методов, чем те, которые перечислены в условиях задач.
* Добавление дополнительных уровней абстракции приветствуется в том случае, если вы готовы обосновать принятые вами решения.

== FAQ ==
Q: Можно ли использовать finalize для закрытия открытых файлов?

A: Нет, нельзя. На лекциях обязательно будет разобрано почему.

Q: Нужно ли всегда использовать утилиту ant?

A: Нет, не нужно. С ней обязательно попрактикуемся отдельно, использовать ее не обязательно.

Q: Нужно ли присылать какие-либо файлы помимо .java (metadata, build.xml)?

A: Нет, не нужно. Стандартный манифест файл, генерируемой утилитой jar, конечно можно оставить в архиве.

== Примеры работы с "файловыми" исключениями ==

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

Можете использовать тот, который вам больше по душе.

<source lang="java">
/**
* The way I always tried to use dealing with "file-reading" exceptions.
*/
public static void firstExample() {
String filename = "filename";
try {
BufferedReader reader = new BufferedReader(new FileReader(filename));
String line;
try {
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
}
}

/**
* The way to get rid of one level of try blocks.
* Significantly reduces depth when dealing with several files.
*/
public static void secondExample() {
String filename = "filename";
BufferedReader reader = null;
try {
reader = new BufferedReader(new FileReader(filename));
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
if (reader != null) {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
}
}

/**
* Brand new Java7 way of dealing with this example.
* Uses try-with-resources statement.
* For more information see:
* http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html
* Remark: some exceptions that you dealt with in two previous examples might be suppressed here.
*/
public static void thirdExample() {
String filename = "filename";
try (BufferedReader reader = new BufferedReader(new FileReader(filename))) {
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened. Message: " + e.getMessage());
e.printStackTrace();
}
}
</source>

== Ссылки ==

Java 2013

2013-03-10T00:49:39Z

Snurk: /* Домашние задания */

Лектор - Кузнецов Антон

Практика - Нурк Сергей

== Рейтинг ==

[https://docs.google.com/spreadsheet/pub?key=0Aif17q2hwUt4dG12aDM0MjI3NlJiOVdXVHpXNVA4alE&output=html Текущий рейтинг]

== Лекции ==

*[[Java_2013-02-08|Лекция 1]]
*[[Медиа:Java_2013_02.ppt|Лекция 2]]
*[http://neerc.ifmo.ru/~kgeorgiy/courses/java-advanced/slides/exceptions.pps Лекция 3 (часть 1)] [[Медиа:Java_2013_03_2.ppt|Лекция 3 (часть 2)]]
*[[Java_2013-02-27|Лекция 4]]

== Домашние задания ==
* [http://mit.spbau.ru/sewiki/images/3/35/Java_hmw_2013_02_20.pdf Первое задание] срок сдачи: 20 февраля
* [http://mit.spbau.ru/sewiki/images/e/e4/Java_hmw_2013_02_27.pdf Второе задание] срок сдачи: 27 февраля
* [http://mit.spbau.ru/sewiki/images/d/db/Java_hmw_2013_03_06.pdf Третье задание] срок сдачи: 06 марта
* [[Java_2013_HW4|Четвертое задание]] срок сдачи: 13 марта
* [http://mit.spbau.ru/sewiki/images/c/c4/Java_hmw_2013_03_20.pdf Пятое задание] срок сдачи: 20 марта

Присылать задачи нужно на почту sergeynurk@gmail.com с копией anton.m.kuznetsov@gmail.com и темой: Java homework <фамилия> tasks 1,2,3...

Вопросы можно задать по тому же почтовому адресу с темой Java question.

== Рекомендуемая литература ==
* "Thinking in Java", Bruce Eckel
* "Effective Java", Joshua Bloch

== Coding conventions ==
В отличие от C++, для Java есть [http://www.oracle.com/technetwork/java/codeconv-138413.html общепринятые coding conventions] от компании Sun.

В первую очередь обратите внимание на Naming Conventions. Настоятельно рекоммендуется отдавать предпочтение длинным мнемоническим идентификаторам.

== Некоторые требования ==

=== Форма поставки кода ===
Задания должны присылаться в jar архивах. В архивы включаются только ваши исходники (.java файлы).

Для создания архивов используйте [http://docs.oracle.com/javase/tutorial/deployment/jar/build.html утилиту jar].

Каждая задача должна находиться в пакете ru.spbau.<ваша фамилия>.task<# задания>

В качестве точки входа должен использоваться класс с именем Main.

Можете складывать несколько заданий в один архив.

=== Javadoc ===
Ко всем классам, интерфейсам и public/protected полям и методам должен быть написан осмысленный [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags javadoc] на грамотном английском языке.

Javadoc должен быть валидным (в частности, содержать все [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags required tags]).

Настоятельно рекоммендуется использовать консольные или встроенные в IDE средства проверки валидности javadoc.

Пример сносного javadoc-а можно найти в любом классе стандартной библиотеки.

=== Exceptions ===
При проверке ваших решений большое внимание будет уделяться тому как вы работаете с исключениями.

Распространенные недочеты:
* Использование исключений для управления логикой программы
* Оборачивание проверяемых исключений в непроверяемые
* Подавление исключений
* Отсутствие вывода читаемой полезной информации в блоках обработки ошибок
* Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)
* Перехват исключений слишком общeго типа

== Общие замечания ==
* Некоторым вашим классам может понадобиться больше public методов, чем те, которые перечислены в условиях задач.
* Добавление дополнительных уровней абстракции приветствуется в том случае, если вы готовы обосновать принятые вами решения.

== FAQ ==
Q: Можно ли использовать finalize для закрытия открытых файлов?

A: Нет, нельзя. На лекциях обязательно будет разобрано почему.

Q: Нужно ли всегда использовать утилиту ant?

A: Нет, не нужно. С ней обязательно попрактикуемся отдельно, использовать ее не обязательно.

Q: Нужно ли присылать какие-либо файлы помимо .java (metadata, build.xml)?

A: Нет, не нужно. Стандартный манифест файл, генерируемой утилитой jar, конечно можно оставить в архиве.

== Примеры работы с "файловыми" исключениями ==

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

Можете использовать тот, который вам больше по душе.

<source lang="java">
/**
* The way I always tried to use dealing with "file-reading" exceptions.
*/
public static void firstExample() {
String filename = "filename";
try {
BufferedReader reader = new BufferedReader(new FileReader(filename));
String line;
try {
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
}
}

/**
* The way to get rid of one level of try blocks.
* Significantly reduces depth when dealing with several files.
*/
public static void secondExample() {
String filename = "filename";
BufferedReader reader = null;
try {
reader = new BufferedReader(new FileReader(filename));
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
if (reader != null) {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
}
}

/**
* Brand new Java7 way of dealing with this example.
* Uses try-with-resources statement.
* For more information see:
* http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html
* Remark: some exceptions that you dealt with in two previous examples might be suppressed here.
*/
public static void thirdExample() {
String filename = "filename";
try (BufferedReader reader = new BufferedReader(new FileReader(filename))) {
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened. Message: " + e.getMessage());
e.printStackTrace();
}
}
</source>

== Ссылки ==

Файл:Java hmw 2013 03 20.pdf

2013-03-10T00:48:49Z

Snurk:

Java 2013

2013-03-10T00:02:48Z

Snurk: /* Форма поставки кода */

Лектор - Кузнецов Антон

Практика - Нурк Сергей

== Рейтинг ==

[https://docs.google.com/spreadsheet/pub?key=0Aif17q2hwUt4dG12aDM0MjI3NlJiOVdXVHpXNVA4alE&output=html Текущий рейтинг]

== Лекции ==

*[[Java_2013-02-08|Лекция 1]]
*[[Медиа:Java_2013_02.ppt|Лекция 2]]
*[http://neerc.ifmo.ru/~kgeorgiy/courses/java-advanced/slides/exceptions.pps Лекция 3 (часть 1)] [[Медиа:Java_2013_03_2.ppt|Лекция 3 (часть 2)]]
*[[Java_2013-02-27|Лекция 4]]

== Домашние задания ==
* [http://mit.spbau.ru/sewiki/images/3/35/Java_hmw_2013_02_20.pdf Первое задание] срок сдачи: 20 февраля
* [http://mit.spbau.ru/sewiki/images/e/e4/Java_hmw_2013_02_27.pdf Второе задание] срок сдачи: 27 февраля
* [http://mit.spbau.ru/sewiki/images/d/db/Java_hmw_2013_03_06.pdf Третье задание] срок сдачи: 06 марта
* [[Java_2013_HW4|Четвертое задание]] срок сдачи: 13 марта

Присылать задачи нужно на почту sergeynurk@gmail.com с копией anton.m.kuznetsov@gmail.com и темой: Java homework <фамилия> tasks 1,2,3...

Вопросы можно задать по тому же почтовому адресу с темой Java question.

== Рекомендуемая литература ==
* "Thinking in Java", Bruce Eckel
* "Effective Java", Joshua Bloch

== Coding conventions ==
В отличие от C++, для Java есть [http://www.oracle.com/technetwork/java/codeconv-138413.html общепринятые coding conventions] от компании Sun.

В первую очередь обратите внимание на Naming Conventions. Настоятельно рекоммендуется отдавать предпочтение длинным мнемоническим идентификаторам.

== Некоторые требования ==

=== Форма поставки кода ===
Задания должны присылаться в jar архивах. В архивы включаются только ваши исходники (.java файлы).

Для создания архивов используйте [http://docs.oracle.com/javase/tutorial/deployment/jar/build.html утилиту jar].

Каждая задача должна находиться в пакете ru.spbau.<ваша фамилия>.task<# задания>

В качестве точки входа должен использоваться класс с именем Main.

Можете складывать несколько заданий в один архив.

=== Javadoc ===
Ко всем классам, интерфейсам и public/protected полям и методам должен быть написан осмысленный [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags javadoc] на грамотном английском языке.

Javadoc должен быть валидным (в частности, содержать все [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags required tags]).

Настоятельно рекоммендуется использовать консольные или встроенные в IDE средства проверки валидности javadoc.

Пример сносного javadoc-а можно найти в любом классе стандартной библиотеки.

=== Exceptions ===
При проверке ваших решений большое внимание будет уделяться тому как вы работаете с исключениями.

Распространенные недочеты:
* Использование исключений для управления логикой программы
* Оборачивание проверяемых исключений в непроверяемые
* Подавление исключений
* Отсутствие вывода читаемой полезной информации в блоках обработки ошибок
* Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)
* Перехват исключений слишком общeго типа

== Общие замечания ==
* Некоторым вашим классам может понадобиться больше public методов, чем те, которые перечислены в условиях задач.
* Добавление дополнительных уровней абстракции приветствуется в том случае, если вы готовы обосновать принятые вами решения.

== FAQ ==
Q: Можно ли использовать finalize для закрытия открытых файлов?

A: Нет, нельзя. На лекциях обязательно будет разобрано почему.

Q: Нужно ли всегда использовать утилиту ant?

A: Нет, не нужно. С ней обязательно попрактикуемся отдельно, использовать ее не обязательно.

Q: Нужно ли присылать какие-либо файлы помимо .java (metadata, build.xml)?

A: Нет, не нужно. Стандартный манифест файл, генерируемой утилитой jar, конечно можно оставить в архиве.

== Примеры работы с "файловыми" исключениями ==

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

Можете использовать тот, который вам больше по душе.

<source lang="java">
/**
* The way I always tried to use dealing with "file-reading" exceptions.
*/
public static void firstExample() {
String filename = "filename";
try {
BufferedReader reader = new BufferedReader(new FileReader(filename));
String line;
try {
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
}
}

/**
* The way to get rid of one level of try blocks.
* Significantly reduces depth when dealing with several files.
*/
public static void secondExample() {
String filename = "filename";
BufferedReader reader = null;
try {
reader = new BufferedReader(new FileReader(filename));
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
if (reader != null) {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
}
}

/**
* Brand new Java7 way of dealing with this example.
* Uses try-with-resources statement.
* For more information see:
* http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html
* Remark: some exceptions that you dealt with in two previous examples might be suppressed here.
*/
public static void thirdExample() {
String filename = "filename";
try (BufferedReader reader = new BufferedReader(new FileReader(filename))) {
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened. Message: " + e.getMessage());
e.printStackTrace();
}
}
</source>

== Ссылки ==

Java 2013

2013-03-10T00:01:24Z

Snurk: /* Exceptions */

Лектор - Кузнецов Антон

Практика - Нурк Сергей

== Рейтинг ==

[https://docs.google.com/spreadsheet/pub?key=0Aif17q2hwUt4dG12aDM0MjI3NlJiOVdXVHpXNVA4alE&output=html Текущий рейтинг]

== Лекции ==

*[[Java_2013-02-08|Лекция 1]]
*[[Медиа:Java_2013_02.ppt|Лекция 2]]
*[http://neerc.ifmo.ru/~kgeorgiy/courses/java-advanced/slides/exceptions.pps Лекция 3 (часть 1)] [[Медиа:Java_2013_03_2.ppt|Лекция 3 (часть 2)]]
*[[Java_2013-02-27|Лекция 4]]

== Домашние задания ==
* [http://mit.spbau.ru/sewiki/images/3/35/Java_hmw_2013_02_20.pdf Первое задание] срок сдачи: 20 февраля
* [http://mit.spbau.ru/sewiki/images/e/e4/Java_hmw_2013_02_27.pdf Второе задание] срок сдачи: 27 февраля
* [http://mit.spbau.ru/sewiki/images/d/db/Java_hmw_2013_03_06.pdf Третье задание] срок сдачи: 06 марта
* [[Java_2013_HW4|Четвертое задание]] срок сдачи: 13 марта

Присылать задачи нужно на почту sergeynurk@gmail.com с копией anton.m.kuznetsov@gmail.com и темой: Java homework <фамилия> tasks 1,2,3...

Вопросы можно задать по тому же почтовому адресу с темой Java question.

== Рекомендуемая литература ==
* "Thinking in Java", Bruce Eckel
* "Effective Java", Joshua Bloch

== Coding conventions ==
В отличие от C++, для Java есть [http://www.oracle.com/technetwork/java/codeconv-138413.html общепринятые coding conventions] от компании Sun.

В первую очередь обратите внимание на Naming Conventions. Настоятельно рекоммендуется отдавать предпочтение длинным мнемоническим идентификаторам.

== Некоторые требования ==

=== Форма поставки кода ===
Задания должны присылаться в jar архивах. В архивы включаются только ваши исходники (.java файлы).

Для создания архивов используйте [http://docs.oracle.com/javase/tutorial/deployment/jar/build.html утилиту jar].

Каждая задача должна находиться в пакете ru.spbau.<ваша фамилия>.task<# задания>

Можете складывать несколько заданий в один архив.

=== Javadoc ===
Ко всем классам, интерфейсам и public/protected полям и методам должен быть написан осмысленный [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags javadoc] на грамотном английском языке.

Javadoc должен быть валидным (в частности, содержать все [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags required tags]).

Настоятельно рекоммендуется использовать консольные или встроенные в IDE средства проверки валидности javadoc.

Пример сносного javadoc-а можно найти в любом классе стандартной библиотеки.

=== Exceptions ===
При проверке ваших решений большое внимание будет уделяться тому как вы работаете с исключениями.

Распространенные недочеты:
* Использование исключений для управления логикой программы
* Оборачивание проверяемых исключений в непроверяемые
* Подавление исключений
* Отсутствие вывода читаемой полезной информации в блоках обработки ошибок
* Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)
* Перехват исключений слишком общeго типа

== Общие замечания ==
* Некоторым вашим классам может понадобиться больше public методов, чем те, которые перечислены в условиях задач.
* Добавление дополнительных уровней абстракции приветствуется в том случае, если вы готовы обосновать принятые вами решения.

== FAQ ==
Q: Можно ли использовать finalize для закрытия открытых файлов?

A: Нет, нельзя. На лекциях обязательно будет разобрано почему.

Q: Нужно ли всегда использовать утилиту ant?

A: Нет, не нужно. С ней обязательно попрактикуемся отдельно, использовать ее не обязательно.

Q: Нужно ли присылать какие-либо файлы помимо .java (metadata, build.xml)?

A: Нет, не нужно. Стандартный манифест файл, генерируемой утилитой jar, конечно можно оставить в архиве.

== Примеры работы с "файловыми" исключениями ==

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

Можете использовать тот, который вам больше по душе.

<source lang="java">
/**
* The way I always tried to use dealing with "file-reading" exceptions.
*/
public static void firstExample() {
String filename = "filename";
try {
BufferedReader reader = new BufferedReader(new FileReader(filename));
String line;
try {
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
}
}

/**
* The way to get rid of one level of try blocks.
* Significantly reduces depth when dealing with several files.
*/
public static void secondExample() {
String filename = "filename";
BufferedReader reader = null;
try {
reader = new BufferedReader(new FileReader(filename));
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
if (reader != null) {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
}
}

/**
* Brand new Java7 way of dealing with this example.
* Uses try-with-resources statement.
* For more information see:
* http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html
* Remark: some exceptions that you dealt with in two previous examples might be suppressed here.
*/
public static void thirdExample() {
String filename = "filename";
try (BufferedReader reader = new BufferedReader(new FileReader(filename))) {
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened. Message: " + e.getMessage());
e.printStackTrace();
}
}
</source>

== Ссылки ==

Java 2013

Java 2013

2013-02-06T12:15:34Z

2012-02-20T21:42:17Z

Snurk: /* Материалы с лекций */

== Новости ==
* 21.02 -- Лучше поздно, чем никогда! Внизу страницы появилось несколько примеров работы с исключениями.
== Материалы с лекций ==
* [[Java_2012-02-09 | Лекция №1]]

== Домашние задания ==
* [http://mit.spbau.ru/sewiki/images/7/71/Java_hmw_2012_02_15.pdf Первое задание] срок сдачи: 15 февраля
* [http://mit.spbau.ru/sewiki/images/c/c1/Java_hmw_2012_02_23_fix.pdf Второе задание] срок сдачи: 23 февраля

Присылать задачи нужно на почту sergeynurk@gmail.com с копией anton.m.kuznetsov@gmail.com и темой: Java homework <фамилия> tasks 1,2,3...

Вопросы можно задать по тому же почтовому адресу с темой Java question.

== Рекомендуемая литература ==
* "Thinking in Java", Bruce Eckel
* "Effective Java", Joshua Bloch

== Coding conventions ==
В отличие от C++, для Java есть [http://www.oracle.com/technetwork/java/codeconv-138413.html общепринятые coding conventions] от компании Sun.

В первую очередь обратите внимание на Naming Conventions. Настоятельно рекоммендуется отдавать предпочтение длинным мнемоническим идентификаторам.

== Некоторые требования ==

=== Форма поставки кода ===
Задания должны присылаться в jar архивах. В архивы включаются только ваши исходники (.java файлы).

Для создания архивов используйте [http://docs.oracle.com/javase/tutorial/deployment/jar/build.html утилиту jar].

Каждая задача должна находиться в пакете ru.spbau.<ваша фамилия>.task<# задания>

Можете складывать несколько заданий в один архив.

=== Javadoc ===
Ко всем классам, интерфейсам и public/protected полям и методам должен быть написан осмысленный [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags javadoc] на грамотном английском языке.

Javadoc должен быть валидным (в частности, содержать все [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags required tags]).

Настоятельно рекоммендуется использовать консольные или встроенные в IDE средства проверки валидности javadoc.

Пример хорошего javadoc-а можно найти в любом классе стандартной библиотеки.

=== Exceptions ===
При проверке ваших решений большое внимание будет уделяться тому как вы работаете с исключениями.

Распространенные недочеты:
* Использование исключений для управления логикой программы
* Оборачивание проверяемых исключений в непроверяемые
* Подавление исключений (Пустые catch блоки)
* Отсутствие вывода читаемой полезной информации в блоках обработки ошибок
* Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)

== Общие замечания ==
* Некоторым вашим классам может понадобиться больше public методов, чем те, которые перечислены в условиях задач.
* Добавление дополнительных уровней абстракции приветствуется в том случае, если вы готовы обосновать принятые вами решения.

== FAQ ==
Q: Можно ли использовать finalize для закрытия открытых файлов?

A: Нет, нельзя. На лекциях обязательно будет разобрано почему.

Q: Нужно ли всегда использовать утилиту ant?

A: Нет, не нужно. С ней обязательно попрактикуемся отдельно, использовать ее не обязательно.

Q: Нужно ли присылать какие-либо файлы помимо .java (metadata, build.xml)?

A: Нет, не нужно. Стандартный манифест файл, генерируемой утилитой jar, конечно можно оставить в архиве.

== Примеры работы с "файловыми" исключениями ==

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

Можете использовать тот, который вам больше по душе.

<source lang="java">
/**
* The way I always tried to use dealing with "file-reading" exceptions.
*/
public static void firstExample() {
String filename = "filename";
try {
BufferedReader reader = new BufferedReader(new FileReader(filename));
String line;
try {
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
}
}

/**
* The way to get rid of one level of try blocks.
* Significantly reduces depth when dealing with several files.
*/
public static void secondExample() {
String filename = "filename";
BufferedReader reader = null;
try {
reader = new BufferedReader(new FileReader(filename));
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
if (reader != null) {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
}
}

/**
* Brand new Java7 way of dealing with this example.
* Uses try-with-resources statement.
* For more information see:
* http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html
* Remark: some exceptions that you dealt with in two previous examples might be suppressed here.
*/
public static void thirdExample() {
String filename = "filename";
try (BufferedReader reader = new BufferedReader(new FileReader(filename))) {
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened. Message: " + e.getMessage());
e.printStackTrace();
}
}
</source>

Java

2012-02-20T21:40:48Z

Snurk: /* 3 примера работы с "файловыми" исключениями */

== Материалы с лекций ==
* [[Java_2012-02-09 | Лекция №1]]

== Домашние задания ==
* [http://mit.spbau.ru/sewiki/images/7/71/Java_hmw_2012_02_15.pdf Первое задание] срок сдачи: 15 февраля
* [http://mit.spbau.ru/sewiki/images/c/c1/Java_hmw_2012_02_23_fix.pdf Второе задание] срок сдачи: 23 февраля

Присылать задачи нужно на почту sergeynurk@gmail.com с копией anton.m.kuznetsov@gmail.com и темой: Java homework <фамилия> tasks 1,2,3...

Вопросы можно задать по тому же почтовому адресу с темой Java question.

== Рекомендуемая литература ==
* "Thinking in Java", Bruce Eckel
* "Effective Java", Joshua Bloch

== Coding conventions ==
В отличие от C++, для Java есть [http://www.oracle.com/technetwork/java/codeconv-138413.html общепринятые coding conventions] от компании Sun.

В первую очередь обратите внимание на Naming Conventions. Настоятельно рекоммендуется отдавать предпочтение длинным мнемоническим идентификаторам.

== Некоторые требования ==

=== Форма поставки кода ===
Задания должны присылаться в jar архивах. В архивы включаются только ваши исходники (.java файлы).

Для создания архивов используйте [http://docs.oracle.com/javase/tutorial/deployment/jar/build.html утилиту jar].

Каждая задача должна находиться в пакете ru.spbau.<ваша фамилия>.task<# задания>

Можете складывать несколько заданий в один архив.

=== Javadoc ===
Ко всем классам, интерфейсам и public/protected полям и методам должен быть написан осмысленный [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags javadoc] на грамотном английском языке.

Javadoc должен быть валидным (в частности, содержать все [http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#requiredtags required tags]).

Настоятельно рекоммендуется использовать консольные или встроенные в IDE средства проверки валидности javadoc.

Пример хорошего javadoc-а можно найти в любом классе стандартной библиотеки.

=== Exceptions ===
При проверке ваших решений большое внимание будет уделяться тому как вы работаете с исключениями.

Распространенные недочеты:
* Использование исключений для управления логикой программы
* Оборачивание проверяемых исключений в непроверяемые
* Подавление исключений (Пустые catch блоки)
* Отсутствие вывода читаемой полезной информации в блоках обработки ошибок
* Некорректное освобождение используемых ресурсов (в первую очередь, открытых ранее файлов)

== Общие замечания ==
* Некоторым вашим классам может понадобиться больше public методов, чем те, которые перечислены в условиях задач.
* Добавление дополнительных уровней абстракции приветствуется в том случае, если вы готовы обосновать принятые вами решения.

== FAQ ==
Q: Можно ли использовать finalize для закрытия открытых файлов?

A: Нет, нельзя. На лекциях обязательно будет разобрано почему.

Q: Нужно ли всегда использовать утилиту ant?

A: Нет, не нужно. С ней обязательно попрактикуемся отдельно, использовать ее не обязательно.

Q: Нужно ли присылать какие-либо файлы помимо .java (metadata, build.xml)?

A: Нет, не нужно. Стандартный манифест файл, генерируемой утилитой jar, конечно можно оставить в архиве.

== Примеры работы с "файловыми" исключениями ==

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

Можете использовать тот, который вам больше по душе.

<source lang="java">
/**
* The way I always tried to use dealing with "file-reading" exceptions.
*/
public static void firstExample() {
String filename = "filename";
try {
BufferedReader reader = new BufferedReader(new FileReader(filename));
String line;
try {
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
}
}

/**
* The way to get rid of one level of try blocks.
* Significantly reduces depth when dealing with several files.
*/
public static void secondExample() {
String filename = "filename";
BufferedReader reader = null;
try {
reader = new BufferedReader(new FileReader(filename));
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened during reading. Message: " + e.getMessage());
e.printStackTrace();
} finally {
if (reader != null) {
try {
reader.close();
} catch (IOException e) {
System.err.println("Strange IOException happened during closing file. Message: " + e.getMessage());
e.printStackTrace();
}
}
}
}

/**
* Brand new Java7 way of dealing with this example.
* Uses try-with-resources statement.
* For more information see:
* http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html
* Remark: some exceptions that you dealt with in two previous examples might be suppressed here.
*/
public static void thirdExample() {
String filename = "filename";
try (BufferedReader reader = new BufferedReader(new FileReader(filename))) {
String line;
while ((line = reader.readLine()) != null) {
/*TODO something*/
System.out.println(line);
}
} catch (FileNotFoundException e) {
System.err.println("Couldn't find file: " + filename);
} catch (IOException e) {
System.err.println("Strange IOException happened. Message: " + e.getMessage());
e.printStackTrace();
}
}
</source>