| /* |
| * Copyright (c) 1999, 2014, Oracle and/or its affiliates. All rights reserved. |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| * |
| * This code is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU General Public License version 2 only, as |
| * published by the Free Software Foundation. Oracle designates this |
| * particular file as subject to the "Classpath" exception as provided |
| * by Oracle in the LICENSE file that accompanied this code. |
| * |
| * This code is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| * version 2 for more details (a copy is included in the LICENSE file that |
| * accompanied this code). |
| * |
| * You should have received a copy of the GNU General Public License version |
| * 2 along with this work; if not, write to the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| * or visit www.oracle.com if you need additional information or have any |
| * questions. |
| */ |
| |
| package com.sun.media.sound; |
| |
| import java.security.AccessController; |
| import java.security.PrivilegedAction; |
| import java.util.ArrayList; |
| import java.util.Collections; |
| import java.util.List; |
| import java.util.Properties; |
| |
| import javax.sound.midi.Receiver; |
| import javax.sound.midi.Sequencer; |
| import javax.sound.midi.Synthesizer; |
| import javax.sound.midi.Transmitter; |
| import javax.sound.midi.spi.MidiDeviceProvider; |
| import javax.sound.midi.spi.MidiFileReader; |
| import javax.sound.midi.spi.MidiFileWriter; |
| import javax.sound.midi.spi.SoundbankReader; |
| import javax.sound.sampled.Clip; |
| import javax.sound.sampled.Port; |
| import javax.sound.sampled.SourceDataLine; |
| import javax.sound.sampled.TargetDataLine; |
| import javax.sound.sampled.spi.AudioFileReader; |
| import javax.sound.sampled.spi.AudioFileWriter; |
| import javax.sound.sampled.spi.FormatConversionProvider; |
| import javax.sound.sampled.spi.MixerProvider; |
| |
| |
| /** |
| * JDK13Services uses the Service class in JDK 1.3 to discover a list of service |
| * providers installed in the system. |
| * <p> |
| * This class is public because it is called from javax.sound.midi.MidiSystem |
| * and javax.sound.sampled.AudioSystem. The alternative would be to make |
| * JSSecurityManager public, which is considered worse. |
| * |
| * @author Matthias Pfisterer |
| */ |
| public final class JDK13Services { |
| |
| /** |
| * Filename of the properties file for default provider properties. This |
| * file is searched in the subdirectory "lib" of the JRE directory (this |
| * behaviour is hardcoded). |
| */ |
| private static final String PROPERTIES_FILENAME = "sound.properties"; |
| |
| /** |
| * Properties loaded from the properties file for default provider |
| * properties. |
| */ |
| private static Properties properties; |
| |
| /** |
| * Private, no-args constructor to ensure against instantiation. |
| */ |
| private JDK13Services() { |
| } |
| |
| /** |
| * Obtains a List containing installed instances of the providers for the |
| * requested service. The returned List is immutable. |
| * |
| * @param serviceClass The type of providers requested. This should be one |
| * of AudioFileReader.class, AudioFileWriter.class, |
| * FormatConversionProvider.class, MixerProvider.class, |
| * MidiDeviceProvider.class, MidiFileReader.class, |
| * MidiFileWriter.class or SoundbankReader.class. |
| * |
| * @return A List of providers of the requested type. This List is |
| * immutable. |
| */ |
| public static List<?> getProviders(final Class<?> serviceClass) { |
| final List<?> providers; |
| if (!MixerProvider.class.equals(serviceClass) |
| && !FormatConversionProvider.class.equals(serviceClass) |
| && !AudioFileReader.class.equals(serviceClass) |
| && !AudioFileWriter.class.equals(serviceClass) |
| && !MidiDeviceProvider.class.equals(serviceClass) |
| && !SoundbankReader.class.equals(serviceClass) |
| && !MidiFileWriter.class.equals(serviceClass) |
| && !MidiFileReader.class.equals(serviceClass)) { |
| providers = new ArrayList<>(0); |
| } else { |
| providers = JSSecurityManager.getProviders(serviceClass); |
| } |
| return Collections.unmodifiableList(providers); |
| } |
| |
| /** Obtain the provider class name part of a default provider property. |
| @param typeClass The type of the default provider property. This |
| should be one of Receiver.class, Transmitter.class, Sequencer.class, |
| Synthesizer.class, SourceDataLine.class, TargetDataLine.class, |
| Clip.class or Port.class. |
| @return The value of the provider class name part of the property |
| (the part before the hash sign), if available. If the property is |
| not set or the value has no provider class name part, null is returned. |
| */ |
| public static synchronized String getDefaultProviderClassName(Class typeClass) { |
| String value = null; |
| String defaultProviderSpec = getDefaultProvider(typeClass); |
| if (defaultProviderSpec != null) { |
| int hashpos = defaultProviderSpec.indexOf('#'); |
| if (hashpos == 0) { |
| // instance name only; leave value as null |
| } else if (hashpos > 0) { |
| value = defaultProviderSpec.substring(0, hashpos); |
| } else { |
| value = defaultProviderSpec; |
| } |
| } |
| return value; |
| } |
| |
| |
| /** Obtain the instance name part of a default provider property. |
| @param typeClass The type of the default provider property. This |
| should be one of Receiver.class, Transmitter.class, Sequencer.class, |
| Synthesizer.class, SourceDataLine.class, TargetDataLine.class, |
| Clip.class or Port.class. |
| @return The value of the instance name part of the property (the |
| part after the hash sign), if available. If the property is not set |
| or the value has no instance name part, null is returned. |
| */ |
| public static synchronized String getDefaultInstanceName(Class typeClass) { |
| String value = null; |
| String defaultProviderSpec = getDefaultProvider(typeClass); |
| if (defaultProviderSpec != null) { |
| int hashpos = defaultProviderSpec.indexOf('#'); |
| if (hashpos >= 0 && hashpos < defaultProviderSpec.length() - 1) { |
| value = defaultProviderSpec.substring(hashpos + 1); |
| } |
| } |
| return value; |
| } |
| |
| |
| /** Obtain the value of a default provider property. |
| @param typeClass The type of the default provider property. This |
| should be one of Receiver.class, Transmitter.class, Sequencer.class, |
| Synthesizer.class, SourceDataLine.class, TargetDataLine.class, |
| Clip.class or Port.class. |
| @return The complete value of the property, if available. |
| If the property is not set, null is returned. |
| */ |
| private static synchronized String getDefaultProvider(Class typeClass) { |
| if (!SourceDataLine.class.equals(typeClass) |
| && !TargetDataLine.class.equals(typeClass) |
| && !Clip.class.equals(typeClass) |
| && !Port.class.equals(typeClass) |
| && !Receiver.class.equals(typeClass) |
| && !Transmitter.class.equals(typeClass) |
| && !Synthesizer.class.equals(typeClass) |
| && !Sequencer.class.equals(typeClass)) { |
| return null; |
| } |
| String name = typeClass.getName(); |
| String value = AccessController.doPrivileged( |
| (PrivilegedAction<String>) () -> System.getProperty(name)); |
| if (value == null) { |
| value = getProperties().getProperty(name); |
| } |
| if ("".equals(value)) { |
| value = null; |
| } |
| return value; |
| } |
| |
| |
| /** Obtain a properties bundle containing property values from the |
| properties file. If the properties file could not be loaded, |
| the properties bundle is empty. |
| */ |
| private static synchronized Properties getProperties() { |
| if (properties == null) { |
| properties = new Properties(); |
| JSSecurityManager.loadProperties(properties, PROPERTIES_FILENAME); |
| } |
| return properties; |
| } |
| } |