Java SE 8. Вводный курс Кей С. Хорстманна

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

В своей книге Кей С. Хорстманн, маститый автор и знаток Java, предлагает вниманию читателей наиболее ценные из новых языковых средств в версии Java 8, а также рассматривает те средства, которые были внедрены в версии Java 7, но не удостоились должного внимания программистов. Те, у кого имеется опыт программирования на Java, найдут в этой книге практические рекомендации и примеры кода, демонстрирующие нововведения в версии Java 8, чтобы как можно быстрее воспользоваться этими и другими усовершенствованиями языка и платформы Java.

В этом незаменимом руководстве рассматриваются следующие важные темы.

• Применение лямбда-выражений для написания вычисляемых фрагментов кода, которые могут быть переданы служебным функциям.
• Новые потоки ввода-вывода, организованные в отдельный прикладной программный интерфейс API, который позволяет значительно повысить эффективность коллекций и удобство обращения с ними.
• Существенное обновление средств параллельного программирования, где применяются лямбда-выражения для выполнения операций фильтрации, отображения, сведения и достигается значительное повышение производительности при обращении с общими счетчиками и хеш-таблицами.
• Полезные рекомендации по практическому применению лямбда-выражений в прикладных программах.
• Описание долгожданной качественно разработанной библиотеки для даты, времени и календаря (JSR 310).
• Прикладной программный интерфейс JavaFX, предназначенный на замену библиотеки Swing для построения графических пользовательских интерфейсов, а также интерпретатор Nashorn языка JavaScript.
• Многочисленные мелкие изменения в библиотеке, позволяющие сделать программирование на Java более продуктивным и приятным занятием.

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

Кей С. Хорстманн — автор книги Scala for the Impatient (издательство Addison-Wesley, 2012 г.), а также основной автор двухтомного издания Core Java™, Volumes I and II, Ninth Edition (издательство Prentice Hall, 2013 г.; в русском переводе это издание вышло в двух томах под общим названием Java. Библиотека профессионала, 9-е изд в ИД «Вильямс», 2014 г.).

Он также написал десяток других книг для профессиональных программистов и изучающих вычислительную технику. Кей служит профессором на кафедре вычислительной техники при университете штата Калифорния в Сан-Хосе, а также является обладателем почетного звания «Чемпион по Java».

Книга обсуждается в отдельном сообщении в блоге Виктора Штонда

Расскажи про книгу своим друзьям и коллегам:

Краткое справочное руководство

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

Необходимость в кратких справочных руководства

Будь то документация для конечного пользователя или документация для разработчика, в кратком справочном руководстве содержится 1-2-страничное руководство, где кратко описаны основные задачи и функции системы.

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

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

Диаграмма была создана в Adobe Illustrator и опубликована в формате PDF. Разработчики сочли такой формат полезным, потому что был охвачен API в целом, показав, как все конечные точки соединены друг с другом в логической гармонии. Для документации API обычное дело, что в кратком справочном руководстве перечислены сокращенные описания конечных точек.

По этой причине вывод Swagger UI часто может служить кратким справочным руководством.

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

Преимущества чистой информации для изучения

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

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

Благодаря такой “чистке” быстрые справочные руководства предоставляют пользователям уникальное преимущество в понимании материала. Предоставление общего обзора системы помогает пользователям получить представление целого, до углубления в детали.

Tip: Подробное описание важности очищения информации для пользователей см. в статье «Упрощение сложности»: сокращение, расслоение и перегонка как стратегия простоты. Чтение обзоров, сводок и другой высокоуровневой информации для быстрого обзора может помочь пользователям понять сложную систему различными способами.

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

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

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

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

Это философия упрощения и языковой эффективности.

Не стоит обманываться краткостью и масштабом краткого справочного руководства. При разработке такого руководства можно потратить несколько дней на написание только одной страницы. Но когда финал может быть отлит золотом!

Примеры краткого руководства

Ниже приведены примеры кратких справочных руководств на различных сайтах документации по API.

Eventful

Eventful предоставляет быстрый список всех конечных точек в API на одной странице, упорядоченный по группам ресурсов. Каждая конечная точка описана примерно в половину строки, поэтому можно быстро понять их все. Например, описание для /events/get в их кратком справочнике: «Получить запись о событии».

Но если щелкнуть для получения более подробной информации, более подробное определение будет «При наличии идентификатора события возвращает данные о событии, связанные с этим событием». , См. http://eventful.com/events/E0-001-000278174-6 для примера интерфейса».

С первого взгляда на конечные точки можно получить определенное понимание. Взглянув с высоты на лес, можно увидеть форму леса в целом. Можно не знать, какие деревья содержит лес, но можно понять другие детали, которые не видны, когда видишь одно дерево.

Parse

Краткий справочник Parse похож на Eventful в том, что это длинный список конечных точек, на этот раз сгруппированный в таблицы. Эта справочная страница является просто разделом в одной длинной single page странице документации. При их подходе вся документация находится на одной странице, но при прокрутке вниз выделяются разные записи на боковой панели.

Иногда разработчикам нравится одностраничный подход, потому что он уменьшает фрагментацию информации и позволяет им использовать Ctrl + F, чтобы найти все экземпляры ключевого слова. Исследования компромиссов такого одностраничного подхода описаны в Single-page docs versus “Click Insanity”.

При использовании справочной документации OpenAPI на GitHub, заметно, что документация также содержится на одной странице. Разработчики могут использовать Ctrl + F , для быстрого поиска. Тем не менее такая документация обеспечивает много визуальной сложности для понимания пользователям.

Shopify

Краткое руководство Shopify не про API, но оно показывает фильтры, переменные и другие функции, доступные в Liquid, который является языком сценариев для разработчиков. Здесь Shopify использует функциональность свертывания и расширения для сжатия информации.

Такое краткое справочное руководство удобно тем, что позволяет одновременно просматривать все доступные функции в Liquid, чтобы знать, что нужно для получения дополнительной информации. Это как карта местности Liquid. Карта позволяет узнать все существующие функции.