# Word forms provider This article gives the knowledge of the API methods which can be used to perform operations about word forms provider interface using Java. The [IWordFormsProvider](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/IWordFormsProvider) interface is designed to implement a word forms provider for searching by word forms. For information on searching by word forms, see [Search for different word forms]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-for-different-word-forms.md" >}}) page. The [IWordFormsProvider](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/IWordFormsProvider) interface contains only one [getWordForms](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/IWordFormsProvider#getWordForms(java.lang.String)) method, which returns various forms for the word passed as an argument. An example implementation of a simple provider of word forms is presented below. ```javascript const wordFormsProvider = java.newProxy('com.groupdocs.search.dictionaries.IWordFormsProvider', { getWordForms: function (word) { const result = []; // Assume that the input word is in the plural, then we add the singular if (word.length > 2 && word.toLowerCase().endsWith('es')) { result.push(word.substr(0, word.length - 2)); } if (word.length > 1 && word.toLowerCase().endsWith('s')) { result.push(word.substr(0, word.length - 1)); } // Then assume that the input word is in the singular, we add the plural if (word.length > 1 && word.toLowerCase().endsWith('y')) { result.push(word.substr(0, word.length - 1) + 'is'); } result.push(word + 's'); result.push(word + 'es'); // All rules are implemented in the EnglishWordFormsProvider class return java.newArray('java.lang.String', result); }, }); ``` By default, the [EnglishWordFormsProvider](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/EnglishWordFormsProvider) class is used, which for English generates various forms of nouns, adjectives, pronouns, verbs, etc. An example of setting a custom provider of word forms is presented below. ```javascript const indexFolder = 'c:/MyIndex/'; const documentsFolder = 'c:/MyDocuments/'; // Creating an index in the specified folder const index = new groupdocs.search.Index(indexFolder, true); // Subscribing to the event index.getEvents().ErrorOccurred.add( java.newProxy('com.groupdocs.search.events.EventHandler', { invoke: function (sender, args) { console.log(args.getMessage()); }, }), ); // Indexing documents from the specified folder index.add(documentsFolder); String.prototype.endsWith = function (str) { var lastIndex = this.lastIndexOf(str); return lastIndex !== -1 && lastIndex + str.length === this.length; }; // Setting the custom word forms provider instance const wordFormsProvider = ... // See code example above index.getDictionaries().setWordFormsProvider(wordFormsProvider); // Creating a search options instance const options = new groupdocs.search.SearchOptions(); options.setUseWordFormsSearch(true); // Enabling search for word forms // Searching in the index const query = 'mrs'; const result = index.search(query, options); // The following words can be found: // mrs // mr ``` ## More resources ### GitHub examples You may easily run the code from documentation articles and see the features in action in our GitHub examples: * [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET) * [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java) ### Free online document search App Along with full featured .NET library we provide simple, but powerful free Apps. You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).