Full Stack AngularJS for Java Developers: Build a FullFeatured Web Application from Scratch Using AngularJS with Spring RESTful 1st Edition Ravi Kant Soni (Auth.)
All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews.
Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the author, nor Packt Publishing, and its dealers and distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book.
Packt Publishing has endeavored to provide trademark information about all of the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information.
First published: December 2013
Production Reference: 1111213
Published by Packt Publishing Ltd. Livery Place 35 Livery Street Birmingham B3 2PB, UK.
ISBN 978-1-78216-656-6 www.packtpub.com
Cover Image by Abhishek Pandey (abhishek.pandey1210@gmail.com)
Credits
Author Alex Knol
Reviewers
Iwan van Staveren
Ruoyu Sun
Acquisition Editor James Jones
Commissioning Editor
Neil Alexander
Technical Editors
Sharvari H. Baet
Dennis John
Copy Editors
Alisha Aranha
Roshni Banerjee
Tanvi Gaitonde
Gladson Monteiro
Shambhavi Pai
Adithi Shetty
Project Coordinator
Sherin Padayatty
Proofreader
Simran Bhogal
Indexer
Rekha Nair
Production Coordinator
Kyle Albuquerque
Cover Work
Kyle Albuquerque
About the Author
Alex Knol is a lifelong tech geek with a passion for automation. After spending some years away from software development, around the beginning of this century, he took up PHP development based on his early experiences with C and Pascal. Surprisingly, he has never really used web tools, but applications instead, to make websites, such as the platform that's driving kaizegine.com. Having built various applications using web technologies and frameworks, such as Symfony, he discovered AngularJS at the beginning of 2008, while searching for a way to structure frontend application code and make development easy. He used AngularJS, among other technologies, for a job-matching project in the Netherlands and, more recently, for an online website designer named Risingtool.com
I'd like to thank the AngularJS team for continuously improving the framework and documentation; my employer, Risingtool.com, for allowing me to work on this book, partly on their time. This book also took time away from my family time, for which I'd like to thank my wife and children.
About the Reviewers
Iwan van Staveren is a software architect. He has over 14 years of experience in developing all kinds of web applications. He loves working with the Symfony2 and AngularJs frameworks. He is owner of the privately-owned E-one Software.
Ruoyu Sun is a designer and developer living in Hong Kong. He is passionate about programming and has been contributing to several open source projects. He has founded several tech startups, using a variety of technologies, before going into the IT industry. He is the author of the book Designing for XOOPS, O'Reilly Media, July 2011.
I would like to thank all my friends and family who have always supported me.
Support files, eBooks, discount offers, and more
You might want to visit www.PacktPub.com for support files and downloads related to your book.
Did you know that Packt offers eBook versions of every book published, with PDF and ePub files available? You can upgrade to the eBook version at www.PacktPub. com and as a print book customer, you are entitled to a discount on the eBook copy. Get in touch with us at service@packtpub.com for more details.
At www.PacktPub.com, you can also read a collection of free technical articles, sign up for a range of free newsletters and receive exclusive discounts and offers on Packt books and eBooks.
TM
http://PacktLib.PacktPub.com
Do you need instant solutions to your IT questions? PacktLib is Packt's online digital book library. Here, you can access, read and search across Packt's entire library of books.
Why subscribe?
• Fully searchable across every book published by Packt
• Copy and paste, print, and bookmark content
• On-demand and accessible via web browsers
Free access for Packt account holders
If you have an account with Packt at www.PacktPub.com, you can use this to access PacktLib today and view nine entirely free books. Simply use your login credentials for immediate access.
Preface
Dependency Injection is a term often used in the world of object-oriented software design. AngularJS depends on it at its core. This book teaches you why and how to use Dependency Injection with AngularJS.
What this book covers
Chapter 1, Learning to Fly, will take you through the basics of an Angular application. This chapter prepares a sample app that will be used throughout the examples in the book.
Chapter 2, Better Code, takes you from bad coding practices to maintainable and testable software using Dependency Injection. It also shows you the theory of Dependency Injection and some of its positive effects.
Chapter 3, The Magic, is a technical explanation of how Dependency Injection can be used with AngularJS and the caveats to watch out for.
Chapter 4, Testing, is a chapter that will show you the advantages that Dependency Injection brings when testing your application. Integration testing and unit testing are covered. The set up and use of recommended AngularJS testing frameworks are covered as well.
Chapter 5, Large Applications, will show you ways to implement the theory and techniques used in large applications. The result will be less code and better maintainability.
What you need for this book
To play along with the examples in this book, you just need a working installation of NodeJS and a text editor. To view the output, a web browser is required.
Who this book is for
If you are a developer or software engineer, this book is ideal for you. You should have a basic understanding of JavaScript and web development.
Conventions
In this book, you will find a number of styles of text that distinguish between different kinds of information. Here are some examples of these styles, and an explanation of their meaning.
Code words in text, database table names, folder names, filenames, file extensions, pathnames, dummy URLs, user input, and Twitter handles are shown as follows: "Earlier, you saw how to use the ng-app attribute to bootstrap the application."
Warnings or important notes appear in a box like this.
Tips and tricks appear like this.
Reader feedback
Feedback from our readers is always welcome. Let us know what you think about this book—what you liked or may have disliked. Reader feedback is important for us to develop titles that you really get the most out of.
To send us general feedback, simply send an e-mail to feedback@packtpub.com, and mention the book title via the subject of your message.
If there is a topic that you have expertise in and you are interested in either writing or contributing to a book, see our author guide on www.packtpub.com/authors.
Customer support
Now that you are the proud owner of a Packt book, we have a number of things to help you to get the most from your purchase.
Downloading the example code
You can download the example code files for all Packt books you have purchased from your account at http://www.packtpub.com. If you purchased this book elsewhere, you can visit http://www.packtpub.com/support and register to have the files e-mailed directly to you.
Errata
Although we have taken every care to ensure the accuracy of our content, mistakes do happen. If you find a mistake in one of our books—maybe a mistake in the text or the code—we would be grateful if you would report this to us. By doing so, you can save other readers from frustration and help us improve subsequent versions of this book. If you find any errata, please report them by visiting http://www.packtpub. com/submit-errata, selecting your book, clicking on the errata submission form link, and entering the details of your errata. Once your errata are verified, your submission will be accepted and the errata will be uploaded on our website, or added to any list of existing errata, under the Errata section of that title. Any existing errata can be viewed by selecting your title from http://www.packtpub.com/support
Piracy
Piracy of copyright material on the Internet is an ongoing problem across all media. At Packt, we take the protection of our copyright and licenses very seriously. If you come across any illegal copies of our works, in any form, on the Internet, please provide us with the location address or website name immediately so that we can pursue a remedy.
Please contact us at copyright@packtpub.com with a link to the suspected pirated material.
We appreciate your help in protecting our authors, and our ability to bring you valuable content.
Questions
You can contact us at questions@packtpub.com if you are having a problem with any aspect of the book, and we will do our best to address it.
Learning to Fly
When you code larger applications in JavaScript, you soon run into a need for some kind of organization for your code. There are a great number of frameworks out there that can help you; the sheer number is enough to just keep you coding as you have done for years. Although there is a learning curve involved like in any framework or tool library, it will help you deliver a better end result with fewer headaches. A handy guide for choosing a framework is http://addyosmani.github.com/todomvc/ It shows you the same app using different tools and libraries.
Let's get going
The traditional way of getting started with any kind of JavaScript library is downloading it from its website or repository and including it in your HTML file. The first thing you see when you go to http://angularjs.org/ is a big Download button. It will take you right to a pop up to download AngularJS. The defaults will be for the latest stable version. Unless you are interested in the source, the minified version will be fine, as shown in the following screenshot:
Learning to Fly
This will download just a minified JavaScript file that you have to include in your HTML file. To get started, your HTML could look like the following:
<!doctype html>
<html lang="en" ng-app="myApp">
<head>
<meta charset="utf-8">
<title>My First html page with AngularJS</title> </head> <body>
<script src="lib/angular. min. js"></script> </body> </html>
In our first code excerpt we have used a local version of the Angular JavaScript files. It is recommended to use the CDN version for production applications:
While AngularJS does a good job of helping you get organized, along the way, it also makes you think a bit differently about DOM and how to manipulate it. When you are used to working just with tools such as jQuery or Prototype, a new dimension and a model, will be added to your world. When you use other frameworks such as KnockoutJS or BackBoneJS, you will feel right at home, but will experience a more opinionated way of writing substantially less code than you were used to.
Let's dive into some code! Let's say you want to ask the user to type a temperature, and depending on the number, show a different response. A simple HTML file with this content would be enough to do that for you, shown as follows: //index.html
Current temperature: <input ng-model='temp' type='number'/> Celcius <p ng-show="temp>=17">Not too bad! {{ temp }} degrees, {{ temp - 10 }} would be a little cold</p> <p ng-show="temp<17">{{ temp }} degrees, is a little chilly, {{ temp + 10 }} would be a nicer</p>
If you like valid HTML, Angular offers ways to specify instructions so that your pages will be completely valid HTML. For instance, you can prefix all the ng-* notations with x- or data-
Now what exactly is happening here? Just below the doctype declaration, you see ng-app. This is a general bootstrapping directive for Angular. In this case, it means that anything between the <HTML> tags can contain instructions for Angular to add its magic to your page. Further down you see some more ng- attributes. The attribute ng-model="temp" binds the value of the input to the variable named temp. Now that the input value is bound, setting the value of the input in the HTML file with value="17" won't work anymore because Angular has bound it to an empty variable. The ng-show attribute triggers a function to show or hide the node it is applied to, based on the evaluation of the expression. All values of the Angular name="value" pairs can contain something that resembles regular JavaScript, although there are differences. Check the documentation to read about the differences at http://docs. angularjs.org/guide/expression. In general, you should keep the amount of "code" in your templates to a minimum to avoid mixing presentation with logic. Now that we have the input, we need something to display the temp variable. Angular, by default, uses double curly braces for interpolating variables in a template, for example, {{ temp }}. As you can see, the interpolation can also contain any valid JavaScript expression; for example, {{ temp + 10 }}.
Delimiters {{ … }}
When you serve your Angular application from a framework like Symfony, the double curly braces {{ }} will conflict with the Twig templating engine, because it also uses the same characters as delimiters. To stay compatible with any plugins that rely on these delimiters on the server side, you should not change them. Angular offers a way to change the delimiters into something else: var myAppModule = angular.module('myApp',[], function ($interpolateProvider) { $interpolateProvider.startSymbol('<['); $interpolateProvider.endSymbol(']>'); });
This will change the stock {{ }} to <[ ]> for the current Angular app.
Learning to Fly
As you saw earlier, the input field was bound to an empty variable temp to begin with. What if we wanted to start with a temperature of, say, 17 degrees? Technically, we could set the value of temp to 17 in the template, but because one of our goals here is to have better code organization, we'll place this nicely inside a JavaScript file.
Adding a controller
Earlier in the chapter, you saw how to use the ng-app attribute to bootstrap the application. We can specialize this bootstrapping to apply a specific piece of JavaScript to the containing nodes. So we could have the <BODY> tag enriched by a bit of Angular. To do this, the file should look like the following:
This will tell Angular to look for a function named TempCtrl inside the included JavaScript files. The JavaScript file that will contain the code will be app.js so, we will need to include that in the HTML file.
To start off with a temperature of 17 degrees, the controller would look like the following:
//app/js/app.js
'use strict';
function TempCtrl($scope) { $scope.temp = 17; }
The controller function is called with the $scope variable. This variable represents the scope the controller is responsible for. All properties of the $scope variable are magically bound to variables of the same name in the HTML template. As you can see, the temperature is simply set to 17 and the manipulation done inside this controller gets synchronized to the template by Angular. The reverse is also true; when a variable is changed in the template, it also gets synced to the controller. Angular has added a two-way binding between the JavaScript code and the HTML template, as shown in the following screenshot:
use strict is optional but helps you, as a developer, to create ECMAScript 5-compatible JavaScript and provides more feedback in supported browsers. For more information, refer to the following link, which is a good read among others http://ejohn.org/blog/ ecmascript-5-strict-mode-json-and-more/.
What about routes?
Next to seeing the actual temperature in the current page, it would be nice to have a page showing some history of what the temperature has been in the past. To do this, we need some kind of routing to navigate between the pages. Along with the routing feature, you will see the Angular module system to organize the various components, shown as follows:
Current temperature: <input ng-model='temp' type='number'/> Celcius <p ng-show="temp>=17">Not too bad! {{ temp }} degrees, {{ temp - 10 }} would be a little cold</p> <p ng-show="temp<17">{{ temp }} degrees, is a little chilly, {{ temp + 10 }} would be a nicer</p>
// partials/history.html
<p>This will show some history</p>
The observant reader will have noticed that the ng-app attribute has been extended with ="tempApp". This is to tell Angular to use a specific module to bootstrap this part of the HTML page. The code that was inside the <BODY> tag has been moved to the partial folder and has been replaced by a navigation menu. The navigation menu just refers to routes using hashbangs (#!). The following manual can help you use the HTML5 History API and allow correct indexing using search engine bots: http://docs.angularjs.org/guide/dev_guide.services.$location. Our module is defined in the following JavaScript file:
First the module is initialized with the name from the template tempApp. The empty array after the module name can contain dependencies for the module. Then the module is configured using $routeProvider as a dependency, which is used to redirect a URI to a partial HTML template using a specific controller. The notation of the controllers has also significantly changed. They are now contained in the module as a property. While defining the controllers as a function in the global scope will still work fine, .controller is the recommended way of writing Angular modules. As before, the temp controller is still depending on $scope to be present inside the function.
Showing a list
The History tab is only showing a placeholder, so let's go ahead and change that. Let's assume we have stored some temperature data in a database and we have read that data into a variable. For demonstration purposes we have just defined some data inside the controller. Fetching data from a backend is beyond the scope of this book:
ng-repeat is an Angular function to do something similar to a for-each loop. Because it is declared on the <ul> tag, it will repeat the elements inside the list for every element it finds in the array historyData value.day just refers to the day property day inside the hash.
Adding a filter
Let's say our users are only interested in temperatures above 15 degrees. We could modify the data in the controller. If we need this same data elsewhere, we could create a copy of the data and modify that for display. Angular has a neat feature called filters. There are several filters included with Angular, but it is simple to create your own filters. First, we'll use a standard Angular filter to convert the names of all days to uppercase:
Angular follows the Unix-style pipe to transfer data down the line using a | symbol. To just show temperatures above 15, we need to filter the historyData array:
This filter takes an array as its argument and returns only those elements with a higher temperature than 15. This piece of code is tightly coupled with the example we have here. The filter is used in a similar way as the uppercase filter we used before:
Now we could make our filter a bit more configurable by making the minimum temperature configurable in the template. That way we can also reuse this filter for lists where we want to see other minimum temperatures:
tempApp.filter('minimum', [ function() { return function(arrTemp, minimum) { var arrReturn = new Array(); var min = minimum ? minimum : 15; angular.forEach(arrTemp, function(value, key){ if(value.temp>=min) arrReturn.push(value); }); return arrReturn; } }]);
Chapter 1
The filter now takes an optional argument as the minimum value to display. When you run the code without changing the template, it works exactly like before. To reflect the new functionality of our filter, we now also have changed the filter's name to minimum. To take advantage of the new feature, we have to specify the minimum temperature as a filter argument. While we are at it, we will let our users decide for themselves what minimum temperature they wish to see:
Our template now has an input box in which the value tempMin is bound to the filter as an argument, shown as follows:
As the user changes the value of the input box, the list is dynamically filtered. To start the input box with the value 15, all we have to do is add $scope.tempMin = 15 to our history controller.
Chart directives
It is not bad to see our data as an unordered list, but showing it in a chart would really make our users happy. We will be using a third-party library to render our chart and wrap it inside an Angular directive. The goal of this exercise is to use our directive as a new HTML tag <chart ...></chart>. This is, by far, one of the coolest features of Angular. For a while the subtitle of the Angular website was after all "teaching HTML new tricks". Let's go ahead and change our template, so it uses our new directive:
The tempChart directive encapsulates a charting library by taking data from the template and returning the rendered chart. One of the key elements in the code snippet is the scope.$watch statement without a specific watchExpression. It simply waits for a $digest run by Angular and will update the data for the chart. $digest is run anytime a key is pressed and Angular calls $apply internally. A good explanation of these concepts is in the Angular manual at http://docs.angularjs.org/guide/concepts
The chart library we used is Morris.js (http://www.oesmith.co.uk/morris.js) and the chart-specific code is annotated because the details of that library are beyond the scope of this book. To get Morris to work correctly, add the following lines to the index.html file:
The result is a page where the user can now use the number input to control the data visualized in the chart.
Using services
One last element of Angular that deserves attention is the concept of services. One of the built-in services is the location service. The location service provides read and write accesses to URLs and lets the developer use it for navigating around the application. It can be used to read and change the URL. Changes can then be picked up by the route service, as we have already seen before. Services are injected into controllers or other services that depend on them.
These are the basic building blocks to create single-page applications using AngularJS. In the following chapters you will learn more about injecting dependencies and why this will benefit you as a developer and your clients.
Downloading the example code
You can download the example code files for all Packt books you have purchased from your account at http://www.packtpub.com. If you purchased this book elsewhere, you can visit http://www.packtpub. com/support and register to have the files e-mailed directly to you.
Learning to Fly
Summary
In this chapter you have seen how to get started with AngularJS. First, we looked at the setup of an Angular project. Then we created a simple page with some angular bindings. We added a controller and another page. The second page showed just a list at first, but got upgraded to a nice chart. We immediately encapsulated the chart in a directive. Lastly, we mentioned services since we had already used them.
Better Code
When we created our HistoryController, we put the historyData object containing days and their corresponding temperatures inside it. For demonstration purposes, this is not the end of the world, but the controller is useless without it. So the controller depends on this object to function correctly. The best thing to do here is to take the hash object out of our controller and replace it with something that will retrieve the data for us. After all, we are not building a static application. Let us refactor that to make it a bit more lifelike by using an external source. For this example, we will use Parse.com, a Backend as a Service (BaaS) that functions like an API. This service can handle all the tasks that we would normally have to handcode in the backend of our applications. Since it is beyond the scope of this book, using a Baas, let us use a backend without coding one up.
Wiring up the backend
We have created a free developer account and imported our sample data into the Parse class Reading using the Parse dashboard.
First the data is moved out of the controller into a file somewhere on the filesystem. Notice the difference in the notation of JSON compared to the previous JavaScript notation. JSON doesn't allow keys to be unquoted. Next, we have to somehow get our controller to use the Parse SDK to get data from the backend. There are a few design patterns that could help us here. The first one is as suggested by Parse the documentation. Just load the following script before the Angular script tag:
After loading the script, you will have to update the controller to get data from Parse.com, using the Parse object from the global scope: //app/controllers.js
tempApp.controller('HistoryCtrl', ['$scope', function ($scope) { Parse.initialize("wNpkWu0OBGAAajJlnnqYPW3wsOT3T43LMn0e3VFb", "04wqQGq62frJjEWzDOhISMrmtWDRFPjGuCoD4zWi");
var Reading = Parse.Object.extend("Reading"); var query = new Parse.Query(Reading); query.find({ success: function (results) { $scope.historyData = []; angular.forEach(results, function (i, e, a) { $scope.historyData.push({ date: i.get('date'), temp: i.get('temp') }) })
//below unchanged $scope.tempMin = 15; $scope.minimum = function (value) { if (value.temp >= $scope.tempMin) return value; } }]);
First, the Parse library needs to know our credentials in order to access the service. This is done in the Parse.initialize call. After that is done a local Reading object is created by extending Parse.Object. This connects our local object to a remote entity named reading. Then, a query is created on the collection of the Reading entities that is used by the Parse service to return all objects in the collection. Upon success, the result is then iterated and pushed into the $scope.historyData property. The end result is the same as before; the template renders our chart directive with the correct historyData object.
Duplicating code
Duplicating code seems like a good approach. We're using a cool service to get our data and insert it in the scope variable. It also looks very clean and concise. There are, however, several problems here. The first is that the credentials are hardcoded and there is a lot of code specific to Parse in our controller now. To illustrate one of the difficulties, we will change our current page so that it will allow users to save the temperature they selected, using the Parse service, shown as follows:
// partials/current.html
Current temperature: <input ng-model='temp' type='number'/> Celcius <p ng-show="temp>=17">Not too bad! {{ temp }} degrees, {{ temp - 10 }} would be a little cold</p> <p ng-show="temp<17">{{ temp }} degrees, is a little chilly, {{ temp + 10 }} would be a nicer</p> <input type="button" ng-click="save()" value="save"/>
First, we have to change the template because we want the user to decide which values get saved to the database using a button. We just added this button as an Angular attribute ng-click="save()". This means that it will execute the function that $scope.save returns when the button is clicked.
// app/controllers.js
tempApp.controller('CurrentCtrl', ['$scope', function ($scope) { $scope.temp = 17;
var Reading = Parse.Object.extend("Reading"); var reading = new Reading();
$scope.save = function () { reading.set("date", new Date().toISOString()); reading.set("temp", $scope.temp); reading.save(null, { success: function (gameScore) { alert('reading saved');
error: function (gameScore, error) { // The save failed. // error is a Parse.Error with an error code and description.
The first few lines are copied straight from our HistoryController. Next, the $scope.save function gets invoked when the user presses the button. We use the Parse SDK syntax to create a new Reading object, fill it with the current date and the selected temperature in it and persist it in the Parse backend. The two-way binding takes care of propagating the value that the user selected from the input element to the $scope.temp variable. To confirm that the save action worked, an alert will be shown with a success message. The same could be done in case of an error. So now when we have an application that works well and performs all that we have asked of it.
However, we have duplicated code which is not very DRY (Don't Repeat Yourself). This means that every time something changes, we have to keep it all in sync with our credentials or the Parse API every time something changes. Secondly, the way to test this service is a bit tricky since we need to have a live Internet connection and a valid Parse account with known data at all times.
When developing in a test-driven manner, you would create your tests at the same time or even before you create the actual code you are testing. We have dedicated a chapter to testing and the advantages of Dependency Injection for testing. So don't worry; we won't forget to create the tests!
Another random document with no related content on Scribd:
The Project Gutenberg eBook of Les mains propres
This ebook is for the use of anyone anywhere in the United States and most other parts of the world at no cost and with almost no restrictions whatsoever. You may copy it, give it away or re-use it under the terms of the Project Gutenberg License included with this ebook or online at www.gutenberg.org. If you are not located in the United States, you will have to check the laws of the country where you are located before using this eBook.
Title: Les mains propres
Essai d'éducation sans dogme
Author: Michel Corday
Release date: August 25, 2023 [eBook #71487]
Language: French
Original publication: Paris: Ernest Flammarion, 1919
Credits: Laurent Vogel and the Online Distributed Proofreading Team at https://www.pgdp.net (This book was produced from images made available by the HathiTrust Digital Library.) *** START OF THE PROJECT GUTENBERG EBOOK LES MAINS PROPRES ***
MICHEL CORDAY
Les mains propres
ESSAI D’ÉDUCATION SANS DOGME
PARIS
ERNEST FLAMMARION, ÉDITEUR
26, RUE RACINE, 26
Tous droits de traduction, d’adaptation et de reproduction réservés pour tous les pays
Il a été tiré, de cet ouvrage, quinze exemplaires sur papier de Hollande, tous numérotés.
OUVRAGES DU MÊME AUTEUR
LIBRAIRIE E. FLAMMARION
Dans la même collection :
Vénus ou les Deux Risques.
Les Embrasés.
Sésame ou la Maternité consentie.
Les Frères Jolidan.
Les Demi-Fous.
La Mémoire du cœur.
Mariage de demain.
Les Révélées.
Les Convenus.
Monsieur, Madame et l’Auto.
Plaisirs d’auto.
Les Casseurs de bois.
EN PRÉPARATION :
Les Feux du Couchant.
Les Hauts Fourneaux.
E. GREVIN IMPRIMERIE DE LAGNY
Droits de traduction et de reproduction réservés pour tous les pays.
Copyright 1919 by E F .
A LA MÉMOIRE DE JEAN JAURÈS
LES MAINS PROPRES
PRÉAMBULE
LE BUT ET LE PLAN
Cet essai s’adresse à ceux qui élèvent leurs enfants en dehors des dogmes, dans un esprit de libre examen.
Quiconque a entrepris cette tâche en sait les difficultés. Dès qu’on réfléchit avant d’agir, dès qu’on se demande pourquoi on agit, dès qu’on ne fait plus une chose uniquement « parce qu’elle se fait », tout devient problème.
On a quitté la bonne vieille grande route, si commode, si facile, si plane, et que le troupeau des générations a suivie. On a devant soi l’espace en friche, où serpentent quelques pistes indécises, toutes fraîches. Où est la bonne direction ? Ici, faut-il prendre à droite, à gauche ? Parfois, on sent l’angoisse du doute. Mais il faut avancer. Alors, on jette des vues, on s’oriente, on se décide. Et l’on marche, en entraînant ses petits par la main.
Il faut que l’effort de chaque pionnier serve à ceux qui lui succéderont. Il faut qu’ils puissent profiter de ses recherches, qu’ils retrouvent les déterminations qu’il a prises, les directions qu’il a suivies, l’empreinte de ses pas.
Cet ouvrage n’a pas d’autre but, ni d’autre plan. C’est un ensemble de modestes solutions aux innombrables problèmes qui
se posent au long de la route. Ce n’est qu’une suite d’opinions. Et on ne s’en étonnera pas. En effet, qu’est-ce qu’éduquer ? C’est compléter, fortifier et redresser, par l’influence du milieu, les notions confuses déposées dans le petit être par l’atavisme et l’hérédité. Or, nous ne pouvons agir sur l’enfant que par notre exemple, nos causeries, nos enseignements ; et nous ne faisons alors, en toutes ces circonstances, qu’imprimer dans la jeune cervelle nos propres opinions sur toutes choses…
La première partie de cet essai est précisément un exposé des opinions générales dont nous souhaitons que les enfants soient pénétrés, plus encore par les entretiens de leurs parents et l’atmosphère du foyer que par la lecture des livres et les leçons des maîtres.
La seconde partie est toute d’adaptation.
Quant au titre de cet ouvrage, il est emprunté à l’une de ces vues morales qui se sont affranchies des anciens dogmes.
PREMIÈRE PARTIE
OPINIONS
CHAPITRE PREMIER
LE BONHEUR
Quand on se lance, hors de la grande route, hors des chemins battus, possède-t-on une indication générale sur la direction à suivre ? La vie humaine a-t-elle une tendance ? Car cette tendance devrait nous guider. Nous devrions marcher dans son sens.
Oh ! Il ne s’agit pas de rechercher le destin final de l’homme. A ce sujet, disons-nous simplement que cette planète mourra comme les autres. Il s’agit de savoir s’il existe une aspiration commune à tous les êtres depuis qu’ils respirent sur la terre, un signe indicateur de la vie. Hélas ! La plupart des humains ne se posent même pas la question. Ils naissent, subsistent, meurent, sans avoir pris conscience de ce qu’ils ont tenté de réaliser pendant leur vie.
Et pourtant, cette tendance existe. Voyez une rue fréquentée, vers le soir. Tous les passants courent, se hâtent, se pressent. Or, si les buts sont différents, le mobile est unique. Obéissant tout droit à leur instinct débridé ou tenus en lisière par le devoir, cherchant l’utile ou l’agréable, la hautaine volupté du sacrifice ou le bas plaisir,
regardant le ciel ou la terre, tous aspirent à réaliser leur désir, tous vont vers leur satisfaction. Oui, tous, malgré des apparences contraires, malgré de déconcertants détours, tous veulent leur bonheur.
C’est l’instinct primordial de toute existence. On le surprend chez le plus infime animalcule dans le champ du microscope. Il fuit la peine et cherche la joie, c’est-à-dire qu’il fuit le milieu où il souffre et cherche le milieu où il se plaît. En quoi il obéit bien à la loi de la vie : car la joie est de la vie accrue, plus intense et plus ardente ; et la douleur est de la vie diminuée, l’acheminement vers la mort.
Mais qu’est-ce donc que le bonheur ? Ce serait folie d’en donner une définition applicable à tous les humains, puisque ce milliard et demi d’êtres sont différents les uns des autres, puisqu’il n’y a pas deux visages — ni sans doute deux cerveaux — identiquement semblables. Il y a autant de bonheurs que d’individus.
Mais peu importe qu’on demande ces joies au pouvoir, aux honneurs, à l’art, aux voyages, aux plaisirs de la table ou de l’amour, à la conscience de la tâche accomplie, aux sereines recherches du laboratoire, aux élans de l’altruisme, aux félicités du propriétaire, du collectionneur, à de modestes travaux manuels, même aux émotions de la chasse ou de la pêche. Tous ces bonheurs ont des traits communs. Ils donnent à l’être sa satisfaction, le sens de la plénitude.
Ils portent la vie à sa plus haute tension.
Il existe dans la nature un exemple de cette tendance continuelle à s’accroître. C’est le végétal. Une plante, une vie humaine s’efforcent toutes deux d’atteindre leur exubérance totale. Elles s’élèvent, l’une vers la lumière, l’autre vers le bonheur.
Au surplus, la croissance de l’esprit est toute pareille à celle de la plante, qui d’abord cherche sa subsistance de toutes parts, aveuglément, par ses mille racines, dans l’obscurité de la terre, puis, s’élançant au jour, se nourrit d’éléments plus subtils, obéit à ses affinités et enfin s’exprime et s’épanouit dans les contours précis de ses verdures fleuries.
Si toutes les manifestations d’une existence, actes et pensées, pouvaient prendre une forme sensible, s’inscrire dans l’espace comme autant de feuilles et de fleurs, l’ensemble d’une vie complète apparaîtrait comme un bel arbre, harmonieux, touffu, luxuriant, étendant ses branches en tous sens, dans un frémissant désir de s’accroître encore.
Un beau rosier est l’image du bonheur
Et, de même qu’il y a des végétaux de toutes tailles, du chêne au brin d’herbe, mais qui tous ont ce caractère commun de remplir leur ligne, de tendre vers leur complet développement, de même il y a des vies de toutes envergures, les unes très modestes, les autres magnifiques, mais qui toutes peuvent être également heureuses, atteindre leur plein épanouissement. Ce n’est pas une question de dimension, c’est une question de densité, de plénitude. Une destinée heureuse, c’est une destinée remplie.
Enfin, de ce point de vue, le but de l’éducation apparaît. Éduquer, c’est cultiver. C’est favoriser l’expansion de la plante humaine. C’est la redresser, l’abreuver, l’émonder, la bien exposer, de façon qu’elle soit forte, saine, qu’elle donne toutes les qualités de l’espèce, qu’elle atteigne sa plus haute puissance.
Devant la morale du bonheur, une objection se dresse aussitôt. Mais, dira-t-on, si chacun poursuit son bonheur, uniquement son bonheur, chacun blessera son voisin, dans cette poursuite. Aussi faut-il en tracer immédiatement les bornes. Oh ! elles sont indiquées dans toutes les morales, par la simple loi : « Tu ne nuiras pas. » Il faut s’arrêter au moment de nuire. Notre bonheur a pour limites le bonheur du voisin.
Pour reprendre l’analogie avec le monde végétal, un groupe humain ne doit plus être l’inculte forêt où les arbres s’étouffent mutuellement. Une société civilisée doit être un jardin, cultivé avec intelligence, où chaque plante, pour donner toutes ses fleurs et tous ses fruits, arrête ses frondaisons aux frondaisons voisines.
Ainsi la plante reste d’un exemple total : monter bien droit, dans la clarté, s’accroître, s’épanouir, s’orner de fleurs, se répandre en parfums, donner des fruits, et ne borner son expansion qu’à l’expansion des autres.
D’ailleurs — et ceci est capital — cette limitation elle-même apparaît de notre intérêt. Les preuves en abondent.
Il est bien certain que si chacun s’efforçait d’observer cette loi restrictive, tant de heurts, de drames, de souffrances seraient évités, que l’état général de l’humanité serait meilleur. Le monde serait plus agréable à habiter. La vie d’un village est symbolique à cet égard. Là, par une lente sagesse, tous les habitants sont parvenus à respecter la terre du voisin. Leur bien se borne au bien d’autrui. Ne sont-ils pas plus heureux que s’ils dépassaient les limites de leur propre domaine et débordaient sans cesse sur les domaines adjacents ? Que de querelles, de luttes, de haines abolies ! Ce serait la guerre. C’est la paix.
Il y a aussi un fait d’expérience qui, dans l’intérêt de notre propre bonheur, doit nous détourner de nuire. C’est que, le plus souvent, tout acte nuisible retombe sur son auteur. La loi d’équilibre, ou de compensation, joue. Cet acte nuisible fait boomerang. On croit le projeter contre autrui. Il revient à son point de départ. Le bonheur conquis sur le voisin n’est plus du bonheur. On l’a payé trop cher. On lui garde rigueur des remords qu’il éveille. Au fond, nous souffrons plus du mal que nous faisons que du mal qu’on nous fait.
Enfin, la notion relativement récente, pour ainsi dire scientifique, de la solidarité, vient encore confirmer qu’il est de notre intérêt de ne pas nuire. En lésant autrui, nous ne sommes jamais sûrs de ne pas nous léser nous-mêmes, précisément parce que toutes les cellules sociales sont dépendantes, solidaires. Quand un point de l’organisme s’enflamme, tout l’organisme a la fièvre. Tout ce qui nuit à la collectivité nuit à l’individu. Celui qui, au mépris de la prudence ou de l’hygiène, jette quelque virus dans la circulation, est-il jamais sûr que le mal, cheminant à travers le monde, ne viendra pas frapper l’un des siens ?
Ainsi, le souci bien compris de notre bonheur même, nous amène à le borner. Et ceux-là se trompent qui accusent la morale du bonheur de n’avoir ni sanctions ni freins. Elle les trouve en ellemême.
Au surplus, la compréhension, le soin de notre propre bonheur, ne nous détournent pas seulement de nuire, de faire le mal. Ils nous incitent aussi à faire le bien, car ces lois d’équilibre et de réciprocité jouent pour le bien comme pour le mal. Faire du bien à autrui, c’est en faire à soi-même. On fait des heureux pour être heureux. On reçoit en reflet le bonheur que l’on donne.
Oui, entre la morale religieuse, froide, tranchante, nue, austère, et la sauvage morale de la force, la morale du browning, il y a place pour une morale souriante, épanouie, rayonnante, la morale de la fleur.
Il ne faut point cependant opposer la morale du bonheur aux morales religieuses. Leur antagonisme est plus apparent que réel. Il est dans les mots. Qui n’applique en fait la morale du bonheur ?
Il faut, au contraire, considérer cette morale humaine comme le prolongement des morales divines. Celles-ci tenaient l’homme en lisière. Elles guidaient ses pas. Elles le jugeaient incapable encore de marcher seul. Ainsi, la morale chrétienne le maintenait dans le droit chemin par la crainte de l’enfer et l’espoir du paradis.
La morale du bonheur marque un progrès. Elle correspond à un état nouveau de civilisation. Elle estime que la créature peut enfin s’affranchir de tutelle, qu’elle est adulte, qu’elle peut avancer sans aide, que sa conscience avertie peut éclairer sa conduite.
Les connaissances humaines se présentent comme un tronc dont trois rameaux ont jailli : art, science, morale. Le premier, l’art, a
donné son élan et ne progresse plus guère ; le deuxième, celui de la science, vient de se développer prodigieusement ; le troisième, celui de la morale, végète. Faut-il désespérer qu’il rattrape les deux autres ?
Il faudrait embellir la vie, la fleurir. N’est-ce pas la tendance générale des progrès humains ? En effet, quels étaient les instincts primitifs de l’homme ? Se nourrir, se reposer, se reproduire. Voyez comme nous avons peu à peu paré, enjolivé ces trois instincts grossiers ! Du besoin de se nourrir, nous avons fait le délicat plaisir de la table. Du besoin de se reposer, la volupté du lit. Et le besoin de se reproduire est devenu l’amour…
Il y a tant à faire, pour embellir la vie, pour l’égayer. Qu’y a-t-il de plus triste qu’une fête foraine ? Ces musées d’horreur, ces jeux de massacre, ces manèges bruyants et laids. Ne pourrait-on pas, peu à peu, couler à des divertissements plus jolis, sans s’écarter du goût de la foule ? On ne dira jamais assez la tristesse des monuments publics. Et les magasins ? Pourquoi ne sont-ils pas généralement plus plaisants aux yeux ? Pourquoi la rôtisserie, la poissonnerie, la boucherie, ne sont-elles pas toujours décorées de céramiques, de marbres ? Pourquoi ne pas rechercher un décor qui soit plus joyeux sans être plus coûteux ? Les tentatives qu’on a faites en ce sens ont presque choqué. Il semble qu’il y ait quelque chose de sacrilège à mettre de la grâce, de la beauté, dans le détail de la vie.
Une humanité travaillant pour le bonheur tendrait à encourager par les plus belles récompenses tous ceux qui collaborent à ce bonheur, l’artiste, l’inventeur… Et ce ne sont pas les grands héros.
Mettons dans notre vie de la grâce, de l’élégance, de la bonté, de la poésie, des enthousiasmes, du plaisir. En un mot, cherchons à l’accroître, à la fleurir, à la faire la plus opulente, la plus luxuriante.
Ayons aussi des raisons, des buts de vivre. Sans quoi, nous descendons à la conception la plus misérable, la plus primitive de la vie, un état inconscient où l’être ne cherche qu’à subsister au jour le jour.
Candide disait : « Cultivons notre jardin ».
Oui. Représentons-nous chaque existence comme un jardin. Et voyez, à surface égale, combien les jardins sont différents. L’un est la brousse, l’autre le paradis. Tout dépend des soins qu’on y donne.
Nous ne pouvons pas prétendre au bonheur absolu, mais nous devons chercher à l’atteindre par le plus grand nombre de points possible.
Notre bonheur est enclos dans notre vie, comme la statue dans le bloc de marbre. C’est à nous de le dégager. Les sculpteurs praticiens procèdent comme si la statue existait déjà dans sa gangue de pierre. Ils l’atteignent par des sondages nombreux, qui s’arrêtent juste à la surface de la future image. Ils la touchent par points. Nous devons être les praticiens de notre bonheur.
Il faut saisir les beaux instants, c’est-à-dire ceux où l’on est heureux sans nuire. Et il faut aussi les proclamer, en soi, autour de soi. On dit plus volontiers : « Quel sale temps ! » que : « Le beau temps… » Il faut que nos propos soient à l’image de la vie, qui roule le bon et le mauvais. Ne serait-ce que pour régler notre pensée sur nos paroles et nous pénétrer de ce sens de l’équilibre.
Il y a d’ailleurs un bonheur dont nous ne prenons pas assez conscience : l’absence de malheur. Par exemple, que de justes petites voluptés on se procure à se rendre compte qu’on ne souffre plus de maux familiers dont on a pâti. Nous n’en jouissons pas. Nous ne nous disons pas assez : « Quelle chance de ne pas avoir mal à la tête, mal aux dents ! »
Au fond, tous nos actes tendent vers l’utile ou l’agréable. Cette formule en deux mots enferme notre vie. C’est un vase qui la contient. A nous d’en faire une belle amphore, de l’élargir vers le haut, d’y mettre toutes les belles fleurs de l’élégance, de l’art, de l’altruisme.
L’aspect d’une roseraie publique, comme celle de Bagatelle, un dimanche, où la foule lente, recueillie, discrète, se promène sous les arceaux de fleurs, apparaît une anticipation, une vision de demain.
CHAPITRE II
LE TEMPS
La foi dans l’avenir. La connaissance de l’avenir. Le présent vaut le passé. L’héritage du passé. Foi dans l’avenir.
Nous aussi, nous croyons à une vie meilleure, à une vie future. Mais nous ne la garantissons pas dans cet au-delà de la mort que nul encore n’a sondé d’un regard certain. Notre vie meilleure, c’est celle de nos descendants. Notre vie meilleure, c’est l’Avenir. Elle n’est pas dans le ciel. Elle est sur la terre. C’est la vie que nous forgeons pour ceux qui nous succéderont. Nous y croyons parce que nous y travaillons, parce qu’elle est le prolongement de notre vie. Voilà l’acte de foi qui doit nous soutenir au cours de notre existence. Cette vie meilleure, nous ne l’attendons pas dans la résignation, sous le joug des dogmes. Nous la préparons, nous apportons notre humble pierre à l’édifice, dans le courage et l’allégresse.
Devant les vagues monstrueuses, stupides et magnifiques qui se jettent et se brisent contre la jetée, je pense que les hommes ont dompté les forces extérieures de la nature et qu’ils n’ont pas encore dompté les forces intérieures, c’est-à-dire celles qui sont en eux : la colère, la haine, la méchanceté, celles qui les poussent à nuire, à tuer… Ils ont asservi les flots, les vents, la foudre ; ils n’ont point encore refréné leurs instincts barbares.
Mais qui donc aurait osé prédire aux premiers hommes ces victoires sur la nature déchaînée ? Et qui peut assurer que les hommes futurs ne couronneront pas cette victoire, en l’achevant sur eux-mêmes ?
Dans les grandes maladies qui frôlent la mort, les êtres se montrent souvent si beaux, si grands, si délicats, si exquis, si touchants, qu’ils dévoilent une humanité supérieure.
Ils montrent ce qu’ils auraient pu être, ce qu’ils auraient été s’ils avaient pu se libérer de toutes les entraves qui les retenaient de montrer le meilleur d’eux-mêmes.
On dirait qu’au seuil de la mort ils voient l’avenir des hommes et déjà le réalisent.
J’entends des gens dire que nous avons la même mentalité que l’homme des cavernes, que la morale n’a pas fait de progrès, parallèlement à la science et sous son influence.
Est-ce bien sûr ? Et surtout s’est-il écoulé assez de temps pour que ces progrès nous soient sensibles ? Les phénomènes d’évolution, ceux qui ont sculpté la surface de la terre, ceux qui ont peu à peu réalisé l’être humain, sont tellement lents, exigent tant de milliers d’années !
Les notions acquises depuis quelques siècles seulement modifient peut-être l’esprit de l’homme. Mais l’empreinte n’est pas encore assez profonde pour que nous discernions ce relief nouveau.
Prenez en exemple la conception de l’infini, la conception qu’il y a des astres derrière les astres, qu’il n’y a pas de limites à l’espace. Elle est récente, puisque les anciens voyaient un univers borné, voûté. Elle est fille de l’astronomie moderne. Or, cette notion de l’infini, de notre terre perdue comme un grain de boue, comme une cellule isolée d’un organisme immense, cette notion n’est-elle pas pour nous montrer la petitesse, la vanité de nos querelles, de nos luttes, et par conséquent pour améliorer peu à peu la morale ? Ne
